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) |
Capabilities
Features and capabilities supported by this server
| 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 | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/klodr/gmail-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server