← Back to browse

gmail

Indexed by com.pulsemcp

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 varsGMAIL_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
Claude 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

Add to 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.