gmail
About
MCP server for Gmail with OAuth2 (personal) and service account (Workspace) support.
Use this server
Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.
Transportstdio (runs a local command)
Env vars
GMAIL_OAUTH_CLIENT_ID GMAIL_OAUTH_CLIENT_SECRET GMAIL_OAUTH_REFRESH_TOKEN GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY GMAIL_IMPERSONATE_EMAIL GMAIL_ENABLED_TOOLGROUPSClaude Code
claude mcp add --env GMAIL_OAUTH_CLIENT_ID= --env GMAIL_OAUTH_CLIENT_SECRET= --env GMAIL_OAUTH_REFRESH_TOKEN= --env GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL= --env GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY= --env GMAIL_IMPERSONATE_EMAIL= --env GMAIL_ENABLED_TOOLGROUPS= gmail -- npx gmail-workspace-mcp-server
Cursor
If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.
VS Code
code --add-mcp '{"name":"gmail","command":"npx","args":["gmail-workspace-mcp-server"],"env":{"GMAIL_OAUTH_CLIENT_ID":"","GMAIL_OAUTH_CLIENT_SECRET":"","GMAIL_OAUTH_REFRESH_TOKEN":"","GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL":"","GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY":"","GMAIL_IMPERSONATE_EMAIL":"","GMAIL_ENABLED_TOOLGROUPS":""}}'
JSON
{
"mcpServers": {
"gmail": {
"command": "npx",
"args": [
"gmail-workspace-mcp-server"
],
"env": {
"GMAIL_OAUTH_CLIENT_ID": "",
"GMAIL_OAUTH_CLIENT_SECRET": "",
"GMAIL_OAUTH_REFRESH_TOKEN": "",
"GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL": "",
"GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY": "",
"GMAIL_IMPERSONATE_EMAIL": "",
"GMAIL_ENABLED_TOOLGROUPS": ""
}
}
}
}
Environment variables are listed by name only — fill in your own values. Entries never carry secrets.