mcpbeat Sign in

Gmail Attachments MCP Server

local only

Gmail Attachments MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 69 installs a week from pypi. Last commit 9 Jun 2026.

Minimal MCP server for downloading Gmail attachments to disk. Read-only OAuth by default.

Installs per day peak 23 · avg 11 · -9% w/w
a month agotoday
69
Installs / week
pypi · gmail-attachments-mcp
2
Stars
1 open issues
9 Jun 2026
Last commit
0 releases in 90 days
MIT
License
Python

Nothing serious here today

Today is the operative word: we check Gmail Attachments MCP every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add gmail-attachments-mcp -- uvx gmail-attachments-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "gmail-attachments-mcp": {
      "args": [
        "gmail-attachments-mcp"
      ],
      "command": "uvx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.gmail-attachments-mcp]
command = "uvx"
args = ["gmail-attachments-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "gmail-attachments-mcp": {
      "args": [
        "gmail-attachments-mcp"
      ],
      "command": "uvx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "gmail-attachments-mcp": {
      "args": [
        "gmail-attachments-mcp"
      ],
      "command": "uvx"
    }
  }
}

This one needs environment variables set before it will start: GMAIL_MCP_CREDENTIALS (Path to the Google OAuth client secret JSON. Default: $XDG_CONFIG_HOME/gmail-attachments-mcp/credentials.json.), GMAIL_MCP_TOKEN (Path to the cached Gmail OAuth refresh token. Default: $XDG_CONFIG_HOME/gmail-attachments-mcp/token.json.), GMAIL_MCP_DEFAULT_DEST_DIR (Default directory where downloaded attachments are saved when the tool call does not specify dest_dir. Default: ~/Downloads.), GMAIL_MCP_SCOPES (Comma-separated Google OAuth scopes. Default: https://www.googleapis.com/auth/gmail.readonly.). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Gmail Attachments MCP

same job, measured the same way
mail-muncher
by craigjmidwinter

Filtered, read-only IMAP and Gmail archived to disk as .eml + markdown, served over MCP.

local only
mail-index
by unsoldgroup

Local-first, read-only MCP server for recall over your Gmail: search, contacts, threads, digests.

55 installs/wk local only
mail-index
by alunsoldantarctica

Local-first, read-only MCP server for recall over your Gmail: search, contacts, threads, digests.

local only
Discord MCP
by jaimenbell

MCP server for the Discord REST API: 5 read tools always on, 7 write tools env-gated, default off.

91 installs/wk local only
Imap MCP Server
by nikolausm

IMAP/SMTP MCP server to search, read, organize, send, reply & forward email for AI assistants

501 installs/wk local only
Gmail
by mintmcp

A MCP server for Gmail that lets you search, read, and draft emails and replies.

answering
MSGraph MCP
by timfurlong

MCP server for Microsoft Graph: Outlook mail and calendar, plus read-only Microsoft Teams

139 installs/wk local only
Sendpulse MCP
by theyahia

MCP server for SendPulse API — mailing lists, email sending, statistics. OAuth2 auth.

34 installs/wk local only

Gmail Attachments MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for Gmail Attachments MCP?
Gmail Attachments MCP runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package gmail-attachments-mcp was installed 69 times last week.
How do I connect Gmail Attachments MCP?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls gmail-attachments-mcp straight from pypi; nothing to host, nothing to sign up for.
How many people use Gmail Attachments MCP?
The pypi package gmail-attachments-mcp was installed 69 times in the last week. Week over week that is -9%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Gmail Attachments MCP open source?
Yes — it is published under the MIT licence, written in Python, 2 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.