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": {
      "args": [
        "-y",
        "gmail-workspace-mcp-server"
      ],
      "command": "npx"
    }
  }
}

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

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

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

This one needs environment variables set before it will start: 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).). The author declared them in the registry entry; get the values from the project itself.