Gmail MCP Server

MCP server for Gmail with OAuth2 (personal) and service account (Workspace) support.

Local serverstdio

What is the Gmail MCP Server?

Gmail is an MCP integration. MCP server for Gmail with OAuth2 (personal) and service account (Workspace) support.

Packages and local setup

The published npm package is gmail-workspace-mcp-server, version 0.4.12. Its declared MCP transport is stdio.

The package declares GMAIL_OAUTH_CLIENT_ID: OAuth2 client ID from Google Cloud Console (for personal Gmail accounts).; GMAIL_OAUTH_CLIENT_SECRET: OAuth2 client secret from Google Cloud Console.; GMAIL_OAUTH_REFRESH_TOKEN: Refresh token from the OAuth2 setup script.; GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL: Service account email address (for Google Workspace).; GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY: Service account private key in PEM format (for Google Workspace).; GMAIL_IMPERSONATE_EMAIL: Email address to impersonate (required for service account mode).; GMAIL_ENABLED_TOOLGROUPS: Comma-separated list of tool groups to enable (readonly, readwrite, readwrite_external)..

This package has launch arguments in its registry record. Use the maintainer’s configuration for those arguments rather than launching it with only the package name.

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.4.12 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related communication MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
GMAIL_OAUTH_CLIENT_IDOAuth2 client ID from Google Cloud Console (for personal Gmail accounts).Optional
GMAIL_OAUTH_CLIENT_SECRETOAuth2 client secret from Google Cloud Console.Optional
GMAIL_OAUTH_REFRESH_TOKENRefresh token from the OAuth2 setup script.Optional
GMAIL_SERVICE_ACCOUNT_CLIENT_EMAILService account email address (for Google Workspace).Optional
GMAIL_SERVICE_ACCOUNT_PRIVATE_KEYService account private key in PEM format (for Google Workspace).Optional
GMAIL_IMPERSONATE_EMAILEmail address to impersonate (required for service account mode).Optional
GMAIL_ENABLED_TOOLGROUPSComma-separated list of tool groups to enable (readonly, readwrite, readwrite_external).Optional