AgentHubAgentHub

Gmail

MCP ServerMCP Registry官方收录

io.github.mcp-z/mcp-gmail · v1.0.10

Gmail integration with OAuth authentication, message search, batch operations, and Sheets export

在 MCP Registry 查看 ↗

概览

Gmail 是一个MCP Server，收录自 官方 MCP Registry。支持 stdio、streamable-http 传输。本页提供 Cursor、Claude Code 等客户端的安装配置片段。

安装

选择你的平台查看安装方式

{
  "mcpServers": {
    "mcp-gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-z/mcp-gmail"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>"
      }
    }
  }
}

环境变量

GOOGLE_CLIENT_ID必填

Google OAuth client ID (required for OAuth authentication modes)

GOOGLE_CLIENT_SECRET可选secret

Google OAuth client secret (optional for public clients)

GOOGLE_SERVICE_ACCOUNT_KEY_FILE可选

Path to service account JSON key file (required for service-account auth mode)

AUTH_MODE可选

Authentication mode

HEADLESS可选

Disable browser auto-open, return auth URL instead (true/false)

REDIRECT_URI可选

OAuth redirect URI (optional, default: ephemeral loopback)

RESOURCE_STORE_URI可选

Resource store URI for CSV export files (file://)

PORT可选

HTTP server port (overrides --port)

BASE_URL可选

Base URL for HTTP transport (used for OAuth/DCR endpoints and file links)

LOG_LEVEL可选

Logging level

GOOGLE_CLIENT_ID必填

Google OAuth client ID (required for OAuth authentication modes)

GOOGLE_CLIENT_SECRET可选secret

Google OAuth client secret (optional for public clients)

GOOGLE_SERVICE_ACCOUNT_KEY_FILE可选

Path to service account JSON key file (required for service-account auth mode)

AUTH_MODE可选

Authentication mode

HEADLESS可选

Disable browser auto-open, return auth URL instead (true/false)

REDIRECT_URI可选

OAuth redirect URI (optional, default: ephemeral loopback)

DCR_MODE可选

Dynamic Client Registration mode

DCR_VERIFY_URL可选

External verification endpoint URL (required for external DCR mode)

DCR_STORE_URI可选

DCR client storage URI (for self-hosted DCR mode)

RESOURCE_STORE_URI可选

Resource store URI for CSV export files (file://)

PORT可选

HTTP server port (overrides --port)

BASE_URL可选

Base URL for HTTP transport (used for OAuth/DCR endpoints and file links)

LOG_LEVEL可选

Logging level

相关资源

统一 Manifest

{
  "id": "io.github.mcp-z/mcp-gmail",
  "type": "mcp-server",
  "version": "1.0.10",
  "displayName": "Gmail",
  "description": "Gmail integration with OAuth authentication, message search, batch operations, and Sheets export",
  "homepage": "https://github.com/mcp-z/mcp-gmail#readme",
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "@mcp-z/mcp-gmail",
        "version": "1.0.10",
        "runtimeHint": "npx",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "GOOGLE_CLIENT_ID",
            "description": "Google OAuth client ID (required for OAuth authentication modes)",
            "isRequired": true
          },
          {
            "name": "GOOGLE_CLIENT_SECRET",
            "description": "Google OAuth client secret (optional for public clients)",
            "isSecret": true
          },
          {
            "name": "GOOGLE_SERVICE_ACCOUNT_KEY_FILE",
            "description": "Path to service account JSON key file (required for service-account auth mode)"
          },
          {
            "name": "AUTH_MODE",
            "description": "Authentication mode"
          },
          {
            "name": "HEADLESS",
            "description": "Disable browser auto-open, return auth URL instead (true/false)"
          },
          {
            "name": "REDIRECT_URI",
            "description": "OAuth redirect URI (optional, default: ephemeral loopback)"
          },
          {
            "name": "RESOURCE_STORE_URI",
            "description": "Resource store URI for CSV export files (file://)"
          },
          {
            "name": "PORT",
            "description": "HTTP server port (overrides --port)"
          },
          {
            "name": "BASE_URL",
            "description": "Base URL for HTTP transport (used for OAuth/DCR endpoints and file links)"
          },
          {
            "name": "LOG_LEVEL",
            "description": "Logging level"
          }
        ]
      },
      {
        "registryType": "npm",
        "identifier": "@mcp-z/mcp-gmail",
        "version": "1.0.10",
        "runtimeHint": "npx",
        "transport": "streamable-http",
        "environmentVariables": [
          {
            "name": "GOOGLE_CLIENT_ID",
            "description": "Google OAuth client ID (required for OAuth authentication modes)",
            "isRequired": true
          },
          {
            "name": "GOOGLE_CLIENT_SECRET",
            "description": "Google OAuth client secret (optional for public clients)",
            "isSecret": true
          },
          {
            "name": "GOOGLE_SERVICE_ACCOUNT_KEY_FILE",
            "description": "Path to service account JSON key file (required for service-account auth mode)"
          },
          {
            "name": "AUTH_MODE",
            "description": "Authentication mode"
          },
          {
            "name": "HEADLESS",
            "description": "Disable browser auto-open, return auth URL instead (true/false)"
          },
          {
            "name": "REDIRECT_URI",
            "description": "OAuth redirect URI (optional, default: ephemeral loopback)"
          },
          {
            "name": "DCR_MODE",
            "description": "Dynamic Client Registration mode"
          },
          {
            "name": "DCR_VERIFY_URL",
            "description": "External verification endpoint URL (required for external DCR mode)"
          },
          {
            "name": "DCR_STORE_URI",
            "description": "DCR client storage URI (for self-hosted DCR mode)"
          },
          {
            "name": "RESOURCE_STORE_URI",
            "description": "Resource store URI for CSV export files (file://)"
          },
          {
            "name": "PORT",
            "description": "HTTP server port (overrides --port)"
          },
          {
            "name": "BASE_URL",
            "description": "Base URL for HTTP transport (used for OAuth/DCR endpoints and file links)"
          },
          {
            "name": "LOG_LEVEL",
            "description": "Logging level"
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.mcp-z/mcp-gmail",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.mcp-z%2Fmcp-gmail/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
Gmail — MCP Server 安装与配置 · AgentHub