Gmail MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add gmail -- npx -y gmail-workspace-mcp-server

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-workspace-mcp-server"
      ]
    }
  }
}

[mcp_servers.gmail]
command = "npx"
args = ["-y", "gmail-workspace-mcp-server"]

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "gmail-workspace-mcp-server"
      ]
    }
  }
}

{
  "servers": {
    "gmail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gmail-workspace-mcp-server"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: 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)).