Loading…
Gmail integration with OAuth authentication, message search, batch operations, and Sheets export
Gmail is an MCP server entry in ChatHome Skills, sourced from Official MCP Registry and scored 100/100. As a Model Context Protocol server, it exposes tools that MCP-compatible LLM clients such as Claude, Cursor, and Copilot can call directly, extending an agent's reach beyond its built-in capabilities. ChatHome Skills discovered this entry through its daily ingest of official registries and GitHub discovery queries, and re-verifies repository facts, freshness signals, and install metadata on every run. The quality score weighs official-registry presence, a working install command, license clarity, GitHub star trajectory, and repository freshness — the full formula is on the Sources page. The install command above is ready to copy. Review the last-pushed date and repository status before adding Gmail to a production agent workflow; the snapshot facts below are point-in-time values from the most recent ingest.
npx -y @mcp-z/mcp-gmail@2.3.3Review the upstream source before running this command.
{
"_meta": {
"io.modelcontextprotocol.registry/official": {
"status": "active",
"isLatest": true,
"updatedAt": "2026-10-12T04:44:26.369699Z",
"publishedAt": "2026-10-12T04:44:26.369699Z",
"statusChangedAt": "2026-10-12T04:44:26.369699Z"
}
},
"server": {
"name": "io.github.mcp-z/mcp-gmail",
"title": "Gmail",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "2.3.3",
"packages": [
{
"version": "2.3.3",
"transport": {
"type": "stdio"
},
"identifier": "@mcp-z/mcp-gmail",
"runtimeHint": "npx",
"registryType": "npm",
"packageArguments": [
{
"name": "--auth",
"type": "named",
"choices": [
"loopback-oauth",
"service-account"
],
"description": "Authentication mode"
},
{
"name": "--headless",
"type": "named",
"description": "Disable browser auto-open, return auth URL instead"
},
{
"name": "--redirect-uri",
"type": "named",
"description": "OAuth redirect URI (default: ephemeral loopback)"
},
{
"name": "--service-account-key-file",
"type": "named",
"description": "Path to service account JSON key file (overrides GOOGLE_SERVICE_ACCOUNT_KEY_FILE env var)"
},
{
"name": "--resource-store-uri",
"type": "named",
"description": "Override resource store URI for CSV export files"
},
{
"name": "--base-url",
"type": "named",
"description": "Override base URL for HTTP transport (used for OAuth/DCR endpoints and file links)"
},
{
"name": "--log-level",
"type": "named",
"choices": [
"debug",
"info",
"warn",
"error"
],
"description": "Override logging level"
}
],
"runtimeArguments": [
{
"name": "-y",
"type": "named"
}
],
"environmentVariables": [
{
"name": "GOOGLE_CLIENT_ID",
"isRequired": true,
"description": "Google OAuth client ID (required for OAuth authentication modes)",
"placeholder": "123456789-abcdefghijk.apps.googleusercontent.com"
},
{
"name": "GOOGLE_CLIENT_SECRET",
"isSecret": true,
"description": "Google OAuth client secret (optional for public clients)",
"placeholder": "GOCSPX-abcdefghijklmnop"
},
{
"name": "GOOGLE_SERVICE_ACCOUNT_KEY_FILE",
"description": "Path to service account JSON key file (required for service-account auth mode)",
"placeholder": "/path/to/service-account-key.json"
},
{
"name": "AUTH_MODE",
"value": "loopback-oauth",
"choices": [
"loopback-oauth",
"service-account"
],
"description": "Authentication mode",
"placeholder": "loopback-oauth"
},
{
"name": "HEADLESS",
"default": "false",
"description": "Disable browser auto-open, return auth URL instead (true/false)",
"placeholder": "false"
},
{
"name": "REDIRECT_URI",
"description": "OAuth redirect URI (optional, default: ephemeral loopback)",
"placeholder": "http://localhost:{PORT}/oauth/callback"
},
{
"name": "RESOURCE_STORE_URI",
"value": "file://~/.mcp-z/mcp-gmail/files",
"description": "Resource store URI for CSV export files (file://)",
"placeholder": "file://~/.mcp-z/mcp-gmail/files"
},
{
"name": "PORT",
"description": "HTTP server port (overrides --port)",
"placeholder": "3000"
},
{
"name": "BASE_URL",
"description": "Base URL for HTTP transport (used for OAuth/DCR endpoints and file links)",
"placeholder": "http://localhost:{PORT}"
},
{
"name": "LOG_LEVEL",
"value": "info",
"choices": [
"debug",
"info",
"warn",
"error"
],
"description": "Logging level",
"placeholder": "info"
}
]
},
{
"version": "2.3.3",
"transport": {
"url": "http://localhost:{PORT}/mcp",
"type": "streamable-http"
},
"identifier": "@mcp-z/mcp-gmail",
"runtimeHint": "npx",
"registryType": "npm",
"packageArguments": [
{
"name": "--port",
"type": "named",
"value": "9002",
"description": "HTTP server port"
},
{
"name": "--auth",
"type": "named",
"choices": [
"loopback-oauth",
"service-account",
"dcr"
],
"description": "Authentication mode"
},
{
"name": "--headless",
"type": "named",
"description": "Disable browser auto-open, return auth URL instead"
},
{
"name": "--redirect-uri",
"type": "named",
"description": "OAuth redirect URI (default: ephemeral loopback)"
},
{
"name": "--service-account-key-file",
"type": "named",
"description": "Path to service account JSON key file (overrides GOOGLE_SERVICE_ACCOUNT_KEY_FILE env var)"
},
{
"name": "--dcr-mode",
"type": "named",
"choices": [
"self-hosted",
"external"
],
"description": "DCR mode"
},
{
"name": "--dcr-verify-url",
"type": "named",
"description": "External verification endpoint URL (required for external DCR mode)"
},
{
"name": "--dcr-store-uri",
"type": "named",
"description": "DCR client storage URI (for self-hosted DCR mode)"
},
{
"name": "--resource-store-uri",
"type": "named",
"description": "Override resource store URI for CSV export files"
},
{
"name": "--base-url",
"type": "named",
"description": "Override base URL for HTTP transport (used for OAuth/DCR endpoints and file links)"
},
{
"name": "--log-level",
"type": "named",
"choices": [
"debug",
"info",
"warn",
"error"
],
"description": "Override logging level"
}
],
"runtimeArguments": [
{
"name": "-y",
"type": "named"
}
],
"environmentVariables": [
{
"name": "GOOGLE_CLIENT_ID",
"isRequired": true,
"description": "Google OAuth client ID (required for OAuth authentication modes)",
"placeholder": "123456789-abcdefghijk.apps.googleusercontent.com"
},
{
"name": "GOOGLE_CLIENT_SECRET",
"isSecret": true,
"description": "Google OAuth client secret (optional for public clients)",
"placeholder": "GOCSPX-abcdefghijklmnop"
},
{
"name": "GOOGLE_SERVICE_ACCOUNT_KEY_FILE",
"description": "Path to service account JSON key file (required for service-account auth mode)",
"placeholder": "/path/to/service-account-key.json"
},
{
"name": "AUTH_MODE",
"value": "loopback-oauth",
"choices": [
"loopback-oauth",
"service-account",
"dcr"
],
"description": "Authentication mode",
"placeholder": "loopback-oauth"
},
{
"name": "HEADLESS",
"default": "false",
"description": "Disable browser auto-open, return auth URL instead (true/false)",
"placeholder": "false"
},
{
"name": "REDIRECT_URI",
"description": "OAuth redirect URI (optional, default: ephemeral loopback)",
"placeholder": "http://localhost:{PORT}/oauth/callback"
},
{
"name": "DCR_MODE",
"choices": [
"self-hosted",
"external"
],
"default": "self-hosted",
"description": "Dynamic Client Registration mode",
"placeholder": "self-hosted"
},
{
"name": "DCR_VERIFY_URL",
"description": "External verification endpoint URL (required for external DCR mode)",
"placeholder": "https://example.com/verify"
},
{
"name": "DCR_STORE_URI",
"default": "file://~/.mcp-z/mcp-gmail/dcr.json",
"description": "DCR client storage URI (for self-hosted DCR mode)",
"placeholder": "file://~/.mcp-z/mcp-gmail/dcr.json"
},
{
"name": "RESOURCE_STORE_URI",
"value": "file://~/.mcp-z/mcp-gmail/files",
"description": "Resource store URI for CSV export files (file://)",
"placeholder": "file://~/.mcp-z/mcp-gmail/files"
},
{
"name": "PORT",
"description": "HTTP server port (overrides --port)",
"placeholder": "3000"
},
{
"name": "BASE_URL",
"description": "Base URL for HTTP transport (used for OAuth/DCR endpoints and file links)",
"placeholder": "http://localhost:{PORT}"
},
{
"name": "LOG_LEVEL",
"value": "info",
"choices": [
"debug",
"info",
"warn",
"error"
],
"description": "Logging level",
"placeholder": "info"
}
]
}
],
"websiteUrl": "https://github.com/mcp-z/mcp-gmail#readme",
"description": "Gmail integration with OAuth authentication, message search, batch operations, and Sheets export"
}
}