Gmail Attachments MCP
A focused Model Context Protocol server (and standalone CLI) for downloading Gmail attachments to disk. Three tools, read-only OAuth scope, no extra surface area. It runs locally over stdio via the published package.
People connecting email tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.
VERIFIED ACTIVE
LAST COMMIT 2026-06-09 · ★ 2 · #67 OF 90 MAINTAINED EMAIL · VERIFIED 2026-09-18
MIT · Python servers · how we verify → /methodology
01 · Install Gmail Attachments MCP
before you install - you'll need
The README does not document required environment variables for a basic install.
Claude Code
claude mcp add zayansalman-gmail-attachments-mcp -- uvx gmail-attachments-mcp Claude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"zayansalman-gmail-attachments-mcp": {
"command": "uvx",
"args": [
"gmail-attachments-mcp"
]
}
}
} Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
license MIT - declared in the repository
pypi package gmail-attachments-mcp - check the name against the project README before installing (PyPI has no namespace ownership)
registry namespace io.github.zayansalman is GitHub-verified and matches the repo owner
03 · Who maintains Gmail Attachments MCP
gmail-attachments-mcp is maintained by zayansalman. We track 3 MCP servers from zayansalman - 3 actively maintained, 2 combined GitHub stars, oldest repo from May 2026.
04 · Facts
- repository
- github.com/zayansalman/gmail-attachments-mcp
- category
- email - ranked #67 of 90 actively-maintained email servers as of 2026-09-18.
- registry
- io.github.zayansalman/gmail-attachments-mcp (active, first published 2026-06-22)
- packages
- pypi:gmail-attachments-mcp
05 · Gmail Attachments MCP FAQ
What is Gmail Attachments MCP?
A focused Model Context Protocol server (and standalone CLI) for downloading Gmail attachments to disk. Three tools, read-only OAuth scope, no extra surface area. It runs locally over stdio via the published package.
Is Gmail Attachments MCP still maintained?
Yes - as of 2026-09-18, its last commit was 2026-06-09. We re-verify nightly.
How do I install Gmail Attachments MCP?
Run `uvx gmail-attachments-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.
Does Gmail Attachments MCP run locally?
Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
06 · Alternatives to Gmail Attachments MCP
Alternatives to Gmail Attachments MCP
Maintained email servers if Gmail Attachments MCP isn't the fit.
- Emailmd Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails. ★ 1,373 · 2026-08-26
- Sessy - Amazon SES observability Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats. ★ 929 · 2026-09-15
- Hqbase Connect AI agents to your self-hosted HQBase shared email workspace. ★ 326 · 2026-09-12
- SendGrid MCP server for SendGrid - global transactional + marketing email (Twilio-owned) ★ 271 · 2026-08-29
- Atomic Mail Programmable email inbox for AI agents - JMAP, PoW auth, stdio MCP server. ★ 267 · 2026-09-10
- Clippy Copy AI-generated content to the macOS clipboard: rich Gmail-ready email drafts, text, and files ★ 247 · 2026-09-04
More email MCP servers · Launch Engine - Business Execution OS · Palmyr · Google Workspace (aaronsb) · Gigamail · FastMCP server for Apollo
More Python MCP servers · Random Number MCP · Servonaut · Webhook.site MCP Server · Zenml · Zernio · see all