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 | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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