MCP Server for Gmail

Build 25.0.9440

StartNotifications

Set up or update a push notification watch on the given user mailbox.

Input

Name Type Required Description
LabelIds String False A comma separated list of labelIds to restrict notifications about. By default, if unspecified, all changes are pushed out. If specified then dictates which labels are required for a push notification to be generated.
LabelFilterBehavior String False Filtering behavior of labelIds list specified.
TopicName String True A fully qualified Google Cloud Pub/Sub API topic name to publish the events to. This topic name must already exist in Cloud Pub/Sub and you must have already granted gmail publish permission on it. For example: projects/my-project-identifier/topics/my-topic-name (using the Cloud Pub/Sub v1 topic naming format)

Result Set Columns

Name Type Description
HistoryId String The ID of the mailbox's current history record.
Expiration String When Gmail will stop sending notifications for mailbox updates (epoch millis). Call the procedure again before this time to renew the watch.

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 25.0.9440