Gmail (npx) MCP Server

123456789101112131415161718192021222324252627282930313233343536373839{
  "type": "stdio",
  "command": "npx",
  "args": [
    "-y",
    "@shinzolabs/gmail-mcp"
  ],
  "env": {
    "GMAIL_OAUTH_PATH": "${input:GMAIL_OAUTH_PATH}",
    "GMAIL_CREDENTIALS_PATH": "${input:GMAIL_CREDENTIALS_PATH}"
  },
  "metadata": {
    "inputs": [
      {
        "id": "GMAIL_OAUTH_PATH",
        "label": "OAuth Keys File Path",
        "description": "Path to your Google Cloud OAuth client keys file (gcp-oauth.keys.json). Create an OAuth 2.0 Client ID of type 'Desktop app' in Google Cloud Console with the Gmail API enabled, download the JSON, and point here. Leave blank to use the default ~/.gmail-mcp/gcp-oauth.keys.json.",
        "type": "file_path",
        "required": false,
        "secret": false,
        "placeholder": "~/.gmail-mcp/gcp-oauth.keys.json",
        "obtain": {
          "url": "https://console.cloud.google.com/apis/credentials",
          "instructions": "1. Open Google Cloud Console > APIs & Services > Credentials\n2. Enable the Gmail API for your project\n3. Configure the OAuth consent screen (add yourself as a test user)\n4. Click 'Create Credentials' > 'OAuth client ID'\n5. Choose application type 'Desktop app'\n6. Download the JSON and save it (e.g. ~/.gmail-mcp/gcp-oauth.keys.json)\n7. Run 'npx @shinzolabs/gmail-mcp auth' once to authorize in the browser and generate the credentials/token file",
          "button_label": "Open Google Cloud Console"
        }
      },
      {
        "id": "GMAIL_CREDENTIALS_PATH",
        "label": "Credentials / Token File Path",
        "description": "Path where the OAuth token (refresh token) is stored after authorizing. Generated by running 'npx @shinzolabs/gmail-mcp auth'. Leave blank to use the default ~/.gmail-mcp/credentials.json.",
        "type": "file_path",
        "required": false,
        "secret": false,
        "placeholder": "~/.gmail-mcp/credentials.json"
      }
    ]
  }
}