mcp-gmail

Gmail

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

communityservice

Package Details

@mcp-z/mcp-gmail

1.0.10•https://www.npmjs.com/package/@mcp-z/mcp-gmail

Transportstdio

Runtimenpx

Runtime Arguments

Named

-y

Package Arguments

Named

--auth

Authentication mode

--headless

Disable browser auto-open, return auth URL instead

--redirect-uri

OAuth redirect URI (default: ephemeral loopback)

--service-account-key-file

Path to service account JSON key file (overrides GOOGLE_SERVICE_ACCOUNT_KEY_FILE env var)

--resource-store-uri

Override resource store URI for CSV export files

--base-url

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

--log-level

Override logging level

Environment Variables

GOOGLE_CLIENT_ID

Required

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

Default:false

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

@mcp-z/mcp-gmail

1.0.10•https://www.npmjs.com/package/@mcp-z/mcp-gmail

TransportStreamable HTTP

Runtimenpx

Runtime Arguments

Named

-y

Package Arguments

Named

--port

9002HTTP server port

--auth

Authentication mode

--headless

Disable browser auto-open, return auth URL instead

--redirect-uri

OAuth redirect URI (default: ephemeral loopback)

--service-account-key-file

Path to service account JSON key file (overrides GOOGLE_SERVICE_ACCOUNT_KEY_FILE env var)

--dcr-mode

DCR 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

Override resource store URI for CSV export files

--base-url

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

--log-level

Override logging level

Environment Variables

GOOGLE_CLIENT_ID

Required

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

Default:false

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

REDIRECT_URI

OAuth redirect URI (optional, default: ephemeral loopback)

DCR_MODE

Default:self-hosted

Dynamic Client Registration mode

DCR_VERIFY_URL

External verification endpoint URL (required for external DCR mode)

DCR_STORE_URI

Default:file://~/.mcp-z/mcp-gmail/dcr.json

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