Gmail Attachments MCP Server

by zayansalman Your server? Claim it

local only

Gmail Attachments MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 349 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 57 · avg 39 · +35% w/w

a month agotoday

349

Installs / week

pypi · gmail-attachments-mcp

Stars

1 open issue

9 Jun 2026

Last commit

from GitHub

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.

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.

Claude Code Claude Desktop Codex Cursor VS Code

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": {
      "command": "uvx",
      "args": [
        "gmail-attachments-mcp"
      ]
    }
  }
}

~/.codex/config.toml

[mcp_servers.gmail-attachments-mcp]
command = "uvx"
args = ["gmail-attachments-mcp"]

.cursor/mcp.json

{
  "mcpServers": {
    "gmail-attachments-mcp": {
      "command": "uvx",
      "args": [
        "gmail-attachments-mcp"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "gmail-attachments-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gmail-attachments-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: 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).

Alternatives to Gmail Attachments MCP

same job, measured the same way

gmail-agent

by dremok

Gmail for AI agents: search, read, download attachments, send, reply, drafts, labels.

93 installs/wk local only

mail-muncher

by craigjmidwinter

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

local only

Meser10 MCP

by meser10

Operate the Meser 10 email and SMS platform from any MCP client. Read-only by default.

40 installs/wk local only

mail-index

by unsoldgroup

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

99 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.

100 installs/wk local only

OpenMail

by openmail

Gmail for agents: create inboxes, read and reply to mail, send email, manage domains. OAuth sign-in.

answering

Tdl MCP

by rixile9999

Read-only Telegram MCP server wrapping the tdl CLI: list chats, read messages, download media.

68 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 349 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 in the form 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 349 times in the last week. Week over week that is +35%. 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, 4 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.