Product
Gmail
Gmail mailboxes, messages, labels and settings, plus Gmail Postmaster Tools.
Install
gmail is one plugin in the google-services-mcps marketplace, and it runs one MCP server with the same name. Install it for Claude Code with the command below. For Codex, OpenCode or Antigravity, change --agent; the product id stays the same.
Install for Claude Code
npx google-services-mcps install --agent claude --plugin gmailWhat it manages
The server carries 2 generated API bindings and 2 gateway APIs. Gateway APIs are reached through api_search, api_describe and api_call, which every product with gateway APIs lists.
| API | Version |
|---|---|
| gmail | v1 |
| gmailpostmastertools | v2 |
| API | Version |
|---|---|
| gmailpostmastertools | v1 |
| gmailpostmastertools | v1beta1 |
Tools
The plugin's server registers 114 tools: 51 reads, 37 writes, 25 destructive actions and 1 dynamic tools. A read never asks. A write is listed only when Allow write tools is on, and asks before it runs. A destructive action asks twice. A dynamic tool decides per call.
Every tool name starts with mcp__plugin_gmail_gmail__, so a call traces back to this product. The table lists the tools this server registers, with the safety class from the plugin's tool map.
| Tool | Class | What it does |
|---|---|---|
| account_remove | write | Remove a signed-in account |
| account_set_default | write | Set the default account |
| accounts_list | read | Signed-in accounts |
| api_call | dynamic | Call an API method |
| api_describe | read | Describe an API method |
| api_methods | read | gmail: API methods |
| api_search | read | Search API methods |
| auth_login | write | Sign in to Google |
| auth_setup_client | write | Save the Google OAuth client |
| auth_status | read | Sign-in status |
| gmail_create_draft | write | Create Gmail draft |
| gmail_create_label | write | Create Gmail label |
| gmail_get_attachment | read | Get Gmail attachment |
| gmail_get_message | read | Get Gmail message |
| gmail_get_thread | read | Get Gmail thread |
| gmail_label | write | Add Gmail labels |
| gmail_list_drafts | read | List Gmail drafts |
| gmail_list_labels | read | List Gmail labels |
| gmail_reply | destructive | Reply to a Gmail message |
| gmail_search | read | Search Gmail |
| gmail_search_threads | read | Search Gmail threads |
| gmail_send | destructive | Send Gmail message |
| gmail_send_as_smime_info_delete | destructive | gmail.users.settings.sendAs.smimeInfo.delete |
| gmail_send_as_smime_info_insert | write | gmail.users.settings.sendAs.smimeInfo.insert |
| gmail_send_as_smime_info_set_default | write | gmail.users.settings.sendAs.smimeInfo.setDefault |
| gmail_send_draft | destructive | Send Gmail draft |
| gmail_settings_addresses_create | destructive | gmail.users.settings.forwardingAddresses.create |
| gmail_settings_addresses_delete | destructive | gmail.users.settings.forwardingAddresses.delete |
| gmail_settings_addresses_list | read | gmail.users.settings.forwardingAddresses.list |
| gmail_settings_cse_identities_create | write | gmail.users.settings.cse.identities.create |
| gmail_settings_cse_identities_delete | destructive | gmail.users.settings.cse.identities.delete |
| gmail_settings_cse_identities_list | read | gmail.users.settings.cse.identities.list |
| gmail_settings_cse_identities_patch | write | gmail.users.settings.cse.identities.patch |
| gmail_settings_cse_keypairs_create | write | gmail.users.settings.cse.keypairs.create |
| gmail_settings_cse_keypairs_disable | destructive | gmail.users.settings.cse.keypairs.disable |
| gmail_settings_cse_keypairs_enable | write | gmail.users.settings.cse.keypairs.enable |
| gmail_settings_cse_keypairs_obliterate | destructive | gmail.users.settings.cse.keypairs.obliterate |
| gmail_settings_forwarding_addresses_get | read | gmail.users.settings.forwardingAddresses.get |
| gmail_settings_get_auto_forwarding | read | gmail.users.settings.getAutoForwarding |
| gmail_settings_send_as_smime_info_get | read | gmail.users.settings.sendAs.smimeInfo.get |
| gmail_settings_send_as_smime_info_list | read | gmail.users.settings.sendAs.smimeInfo.list |
| gmail_settings_update_auto_forwarding | destructive | gmail.users.settings.updateAutoForwarding |
| gmail_trash | destructive | Move to Gmail Trash |
| gmail_unlabel | write | Remove Gmail labels |
| gmail_untrash | write | Restore from Gmail Trash |
| gmail_users_drafts_delete | destructive | gmail.users.drafts.delete |
| gmail_users_drafts_get | read | gmail.users.drafts.get |
| gmail_users_drafts_list | read | gmail.users.drafts.list |
| gmail_users_get_profile | read | gmail.users.getProfile |
| gmail_users_history_list | read | gmail.users.history.list |
| gmail_users_labels_create | write | gmail.users.labels.create |
| gmail_users_labels_delete | destructive | gmail.users.labels.delete |
| gmail_users_labels_get | read | gmail.users.labels.get |
| gmail_users_labels_list | read | gmail.users.labels.list |
| gmail_users_labels_patch | write | gmail.users.labels.patch |
| gmail_users_labels_update | write | gmail.users.labels.update |
| gmail_users_messages_attachments_get | read | gmail.users.messages.attachments.get |
| gmail_users_messages_batch_delete | destructive | gmail.users.messages.batchDelete |
| gmail_users_messages_batch_modify | write | gmail.users.messages.batchModify |
| gmail_users_messages_delete | destructive | gmail.users.messages.delete |
| gmail_users_messages_get | read | gmail.users.messages.get |
| gmail_users_messages_list | read | gmail.users.messages.list |
| gmail_users_messages_modify | write | gmail.users.messages.modify |
| gmail_users_messages_trash | destructive | gmail.users.messages.trash |
| gmail_users_messages_untrash | write | gmail.users.messages.untrash |
| gmail_users_settings_cse_identities_get | read | gmail.users.settings.cse.identities.get |
| gmail_users_settings_cse_keypairs_get | read | gmail.users.settings.cse.keypairs.get |
| gmail_users_settings_cse_keypairs_list | read | gmail.users.settings.cse.keypairs.list |
| gmail_users_settings_delegates_create | destructive | gmail.users.settings.delegates.create |
| gmail_users_settings_delegates_delete | destructive | gmail.users.settings.delegates.delete |
| gmail_users_settings_delegates_get | read | gmail.users.settings.delegates.get |
| gmail_users_settings_delegates_list | read | gmail.users.settings.delegates.list |
| gmail_users_settings_filters_create | write | gmail.users.settings.filters.create |
| gmail_users_settings_filters_delete | destructive | gmail.users.settings.filters.delete |
| gmail_users_settings_filters_get | read | gmail.users.settings.filters.get |
| gmail_users_settings_filters_list | read | gmail.users.settings.filters.list |
| gmail_users_settings_get_imap | read | gmail.users.settings.getImap |
| gmail_users_settings_get_language | read | gmail.users.settings.getLanguage |
| gmail_users_settings_get_pop | read | gmail.users.settings.getPop |
| gmail_users_settings_get_vacation | read | gmail.users.settings.getVacation |
| gmail_users_settings_send_as_create | write | gmail.users.settings.sendAs.create |
| gmail_users_settings_send_as_delete | destructive | gmail.users.settings.sendAs.delete |
| gmail_users_settings_send_as_get | read | gmail.users.settings.sendAs.get |
| gmail_users_settings_send_as_list | read | gmail.users.settings.sendAs.list |
| gmail_users_settings_send_as_patch | write | gmail.users.settings.sendAs.patch |
| gmail_users_settings_send_as_update | write | gmail.users.settings.sendAs.update |
| gmail_users_settings_send_as_verify | write | gmail.users.settings.sendAs.verify |
| gmail_users_settings_update_imap | write | gmail.users.settings.updateImap |
| gmail_users_settings_update_language | write | gmail.users.settings.updateLanguage |
| gmail_users_settings_update_pop | write | gmail.users.settings.updatePop |
| gmail_users_settings_update_vacation | write | gmail.users.settings.updateVacation |
| gmail_users_stop | destructive | gmail.users.stop |
| gmail_users_threads_delete | destructive | gmail.users.threads.delete |
| gmail_users_threads_get | read | gmail.users.threads.get |
| gmail_users_threads_list | read | gmail.users.threads.list |
| gmail_users_threads_modify | write | gmail.users.threads.modify |
| gmail_users_threads_trash | destructive | gmail.users.threads.trash |
| gmail_users_threads_untrash | write | gmail.users.threads.untrash |
| gmail_users_watch | write | gmail.users.watch |
| gmailpost_domains_get_compliance_status | read | gmailpostmastertools.domains.getComplianceStatus |
| gmailpostm_domain_stats_batch_query | read | gmailpostmastertools.domainStats.batchQuery |
| gmailpostm_domains_create | write | gmailpostmastertools.domains.create |
| gmailpostm_domains_delete | destructive | gmailpostmastertools.domains.delete |
| gmailpostm_domains_domain_stats_query | read | gmailpostmastertools.domains.domainStats.query |
| gmailpostm_domains_get | read | gmailpostmastertools.domains.get |
| gmailpostm_domains_list | read | gmailpostmastertools.domains.list |
| gmailpostm_domains_users_create | write | gmailpostmastertools.domains.users.create |
| gmailpostm_domains_users_delete | destructive | gmailpostmastertools.domains.users.delete |
| gmailpostm_domains_users_get | read | gmailpostmastertools.domains.users.get |
| gmailpostm_domains_users_list | read | gmailpostmastertools.domains.users.list |
| gmailpostm_domains_users_patch | write | gmailpostmastertools.domains.users.patch |
| gmailpostm_domains_verify | write | gmailpostmastertools.domains.verify |
| gmailpostm_get_verification_token | read | gmailpostmastertools.domains.getVerificationToken |
| health | read | Server health |
The plugin option toolset can list fewer tools. google lists 13 tools that do the same jobs as Google's official MCP server for this product; curated lists the hand-written and gateway tools; all is the default.
Sign-in
gmail belongs to the workspace-user login group. Log in once for the group: create a Desktop OAuth client in a Google Cloud project, save its file with npx google-services-mcps setup-client, then run npx google-services-mcps login workspace-user. Products in this group share the one login.
The plugin's scope file lists 18 OAuth scopes for 1 APIs. A login asks only for the scopes of its profile: readonly (the default), readwrite, full, or an exact list.
| API | Scope |
|---|---|
| gmail | https://mail.google.com/ |
| gmail | https://www.googleapis.com/auth/gmail.addons.current.action.compose |
| gmail | https://www.googleapis.com/auth/gmail.addons.current.message.action |
| gmail | https://www.googleapis.com/auth/gmail.addons.current.message.metadata |
| gmail | https://www.googleapis.com/auth/gmail.addons.current.message.readonly |
| gmail | https://www.googleapis.com/auth/gmail.compose |
| gmail | https://www.googleapis.com/auth/gmail.insert |
| gmail | https://www.googleapis.com/auth/gmail.labels |
| gmail | https://www.googleapis.com/auth/gmail.metadata |
| gmail | https://www.googleapis.com/auth/gmail.modify |
| gmail | https://www.googleapis.com/auth/gmail.readonly |
| gmail | https://www.googleapis.com/auth/gmail.send |
| gmail | https://www.googleapis.com/auth/gmail.settings.basic |
| gmail | https://www.googleapis.com/auth/gmail.settings.sharing |
| gmail | https://www.googleapis.com/auth/postmaster |
| gmail | https://www.googleapis.com/auth/postmaster.domain |
| gmail | https://www.googleapis.com/auth/postmaster.traffic.readonly |
| gmail | https://www.googleapis.com/auth/postmaster.user |
Plugin details
- Plugin
- gmail
- MCP server
- gmail
- Display name
- Gmail
- Version
- 2.17.0
- Marketplace
- google-services-mcps
- Login group
- workspace-user
- Marketplace category
- productivity
- Plugin options
- allow_writes, confirmation, token_dir, toolset
- Server kind
- curated+discovery