Gmail Attachments MCP
Minimal MCP server for downloading Gmail attachments to disk. Read-only OAuth by default.
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- 4 days ago
About Gmail Attachments MCP
Gmail Attachments MCP is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add gmail-attachments-mcp --env GMAIL_MCP_TOKEN='<GMAIL_MCP_TOKEN>' -- uvx gmail-attachments-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"gmail-attachments-mcp": {
"command": "uvx",
"args": [
"gmail-attachments-mcp"
],
"env": {
"GMAIL_MCP_TOKEN": "<GMAIL_MCP_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gmail-attachments-mcp": {
"command": "uvx",
"args": [
"gmail-attachments-mcp"
],
"env": {
"GMAIL_MCP_TOKEN": "<GMAIL_MCP_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"gmail-attachments-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"gmail-attachments-mcp"
],
"env": {
"GMAIL_MCP_TOKEN": "<GMAIL_MCP_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gmail-attachments-mcp": {
"command": "uvx",
"args": [
"gmail-attachments-mcp"
],
"env": {
"GMAIL_MCP_TOKEN": "<GMAIL_MCP_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gmail-attachments-mcp": {
"command": "uvx",
"args": [
"gmail-attachments-mcp"
],
"env": {
"GMAIL_MCP_TOKEN": "<GMAIL_MCP_TOKEN>"
}
}
}
}Configuration
GMAIL_MCP_CREDENTIALSPath to the Google OAuth client secret JSON. Default: $XDG_CONFIG_HOME/gmail-attachments-mcp/credentials.json.GMAIL_MCP_TOKENPath to the cached Gmail OAuth refresh token. Default: $XDG_CONFIG_HOME/gmail-attachments-mcp/token.json.GMAIL_MCP_DEFAULT_DEST_DIRDefault directory where downloaded attachments are saved when the tool call does not specify dest_dir. Default: ~/Downloads.GMAIL_MCP_SCOPESComma-separated Google OAuth scopes. Default: https://www.googleapis.com/auth/gmail.readonly.
Pricing
Open source
Gmail Attachments MCP FAQ
Is Gmail Attachments MCP free?
Yes. Gmail Attachments MCP is open source, so you can use and self-host it for free.
How do I add Gmail Attachments MCP to Claude Code?
Run this command in your terminal: claude mcp add gmail-attachments-mcp --env GMAIL_MCP_TOKEN='<GMAIL_MCP_TOKEN>' -- uvx gmail-attachments-mcp
What are the best alternatives to Gmail Attachments MCP?
The closest alternatives to Gmail Attachments MCP are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to Gmail Attachments MCP

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity