gmail-mcp
by klodr
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GMAIL_OAUTH_PATH | No | Path to Google Cloud OAuth credentials JSON file (default: ~/.gmail-mcp/gcp-oauth.keys.json) | |
| GMAIL_MCP_AUDIT_LOG | No | Absolute path for opt-in JSONL audit log of tool calls | |
| GMAIL_MCP_STATE_DIR | No | Directory for rate limit state persistence (default: ~/.gmail-mcp/) | |
| GMAIL_CREDENTIALS_PATH | No | Path to store access/refresh tokens (default: ~/.gmail-mcp/credentials.json) | |
| GMAIL_MCP_DOWNLOAD_DIR | No | Download jail directory for download_email and download_attachment (default: ~/GmailDownloads/) | |
| GMAIL_MCP_ATTACHMENT_DIR | No | Attachment jail directory for send/draft/reply_all (default: ~/GmailAttachments/) | |
| GMAIL_MCP_RATE_LIMIT_send | No | Override rate limit for send bucket (format: D/day,M/month, default: 400/6000) | |
| GMAIL_MCP_RATE_LIMIT_delete | No | Override rate limit for delete bucket (format: D/day,M/month, default: 200/2000) | |
| GMAIL_MCP_RATE_LIMIT_drafts | No | Override rate limit for drafts bucket (format: D/day,M/month, default: 300/3000) | |
| GMAIL_MCP_RATE_LIMIT_labels | No | Override rate limit for labels bucket (format: D/day,M/month, default: 50/500) | |
| GMAIL_MCP_RATE_LIMIT_modify | No | Override rate limit for modify bucket (format: D/day,M/month, default: 500/5000) | |
| GMAIL_MCP_RATE_LIMIT_DISABLE | No | Disable all rate limiting if set to 'true' | |
| GMAIL_MCP_RATE_LIMIT_filters | No | Override rate limit for filters bucket (format: D/day,M/month, default: 20/200) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| prompts | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| unread-emails | Show every unread email in the inbox with sender, subject, and date. |
| unread-stale | Show unread emails older than a threshold (e.g. `7d`, `1m`) that haven't been processed. |
| inbox-reclass | Sort the inbox and apply the correct label: newsletters → Newsletters, notifications → Notifications, social networks → Social, forums → Forums. |
| detect-phishing | Scan the inbox for phishing indicators and tag matches with a `Phishing` label. |
| detect-spam | Scan the inbox for spam indicators that Gmail's own filter missed and tag matches with a `Spam` label (without auto-moving — the user decides). |
| unread-triage | List every unread email grouped by category, each with a recommended action (archive / reply / delete) so the user can pick per entry. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Maintenance
ActivitySlowing
ResponsivenessUnresponsive