MCP Server

com.pulsemcp/gmail MCP Server

Name: com.pulsemcp/gmail MCP Server
Author: com.pulsemcp

com.pulsemcp/gmail

Repository Registry

What is the com.pulsemcp/gmail MCP server?

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

How to install com.pulsemcp/gmail

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GMAIL_OAUTH_CLIENT_ID
secret
OAuth2 client ID from Google Cloud Console (for personal Gmail accounts).
GMAIL_OAUTH_CLIENT_SECRET
secret
OAuth2 client secret from Google Cloud Console.
GMAIL_OAUTH_REFRESH_TOKEN
secret
Refresh token from the OAuth2 setup script.
GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL
Service account email address (for Google Workspace).
GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY
secret
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).

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-workspace-mcp-server",
        "-y"
      ],
      "env": {
        "GMAIL_OAUTH_CLIENT_ID": "<YOUR_GMAIL_OAUTH_CLIENT_ID>",
        "GMAIL_OAUTH_CLIENT_SECRET": "<YOUR_GMAIL_OAUTH_CLIENT_SECRET>",
        "GMAIL_OAUTH_REFRESH_TOKEN": "<YOUR_GMAIL_OAUTH_REFRESH_TOKEN>",
        "GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<YOUR_GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY": "<YOUR_GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_IMPERSONATE_EMAIL": "<YOUR_GMAIL_IMPERSONATE_EMAIL>",
        "GMAIL_ENABLED_TOOLGROUPS": "<YOUR_GMAIL_ENABLED_TOOLGROUPS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-workspace-mcp-server",
        "-y"
      ],
      "env": {
        "GMAIL_OAUTH_CLIENT_ID": "<YOUR_GMAIL_OAUTH_CLIENT_ID>",
        "GMAIL_OAUTH_CLIENT_SECRET": "<YOUR_GMAIL_OAUTH_CLIENT_SECRET>",
        "GMAIL_OAUTH_REFRESH_TOKEN": "<YOUR_GMAIL_OAUTH_REFRESH_TOKEN>",
        "GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<YOUR_GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY": "<YOUR_GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_IMPERSONATE_EMAIL": "<YOUR_GMAIL_IMPERSONATE_EMAIL>",
        "GMAIL_ENABLED_TOOLGROUPS": "<YOUR_GMAIL_ENABLED_TOOLGROUPS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-workspace-mcp-server",
        "-y"
      ],
      "env": {
        "GMAIL_OAUTH_CLIENT_ID": "<YOUR_GMAIL_OAUTH_CLIENT_ID>",
        "GMAIL_OAUTH_CLIENT_SECRET": "<YOUR_GMAIL_OAUTH_CLIENT_SECRET>",
        "GMAIL_OAUTH_REFRESH_TOKEN": "<YOUR_GMAIL_OAUTH_REFRESH_TOKEN>",
        "GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<YOUR_GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY": "<YOUR_GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_IMPERSONATE_EMAIL": "<YOUR_GMAIL_IMPERSONATE_EMAIL>",
        "GMAIL_ENABLED_TOOLGROUPS": "<YOUR_GMAIL_ENABLED_TOOLGROUPS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "gmail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gmail-workspace-mcp-server",
        "-y"
      ],
      "env": {
        "GMAIL_OAUTH_CLIENT_ID": "<YOUR_GMAIL_OAUTH_CLIENT_ID>",
        "GMAIL_OAUTH_CLIENT_SECRET": "<YOUR_GMAIL_OAUTH_CLIENT_SECRET>",
        "GMAIL_OAUTH_REFRESH_TOKEN": "<YOUR_GMAIL_OAUTH_REFRESH_TOKEN>",
        "GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<YOUR_GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY": "<YOUR_GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_IMPERSONATE_EMAIL": "<YOUR_GMAIL_IMPERSONATE_EMAIL>",
        "GMAIL_ENABLED_TOOLGROUPS": "<YOUR_GMAIL_ENABLED_TOOLGROUPS>"
      }
    }
  }
}

Claude Code

claude mcp add gmail --env GMAIL_OAUTH_CLIENT_ID=<YOUR_GMAIL_OAUTH_CLIENT_ID> --env GMAIL_OAUTH_CLIENT_SECRET=<YOUR_GMAIL_OAUTH_CLIENT_SECRET> --env GMAIL_OAUTH_REFRESH_TOKEN=<YOUR_GMAIL_OAUTH_REFRESH_TOKEN> --env GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL=<YOUR_GMAIL_SERVICE_ACCOUNT_CLIENT_EMAIL> --env GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY=<YOUR_GMAIL_SERVICE_ACCOUNT_PRIVATE_KEY> --env GMAIL_IMPERSONATE_EMAIL=<YOUR_GMAIL_IMPERSONATE_EMAIL> --env GMAIL_ENABLED_TOOLGROUPS=<YOUR_GMAIL_ENABLED_TOOLGROUPS> -- npx -y gmail-workspace-mcp-server -y