io.github.zayansalman

gmail-attachments-mcp

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

stdiocommunityapplication

Package Details

gmail-attachments-mcp

0.1.0•https://pypi.org/project/gmail-attachments-mcp
Transportstdio

Package Arguments

Positional
Position 0
serveSubcommand that runs the stdio MCP server.

Environment Variables

GMAIL_MCP_CREDENTIALS(file)

Path to the Google OAuth client secret JSON. Default: $XDG_CONFIG_HOME/gmail-attachments-mcp/credentials.json.

GMAIL_MCP_TOKEN(file)
Secret

Path to the cached Gmail OAuth refresh token. Default: $XDG_CONFIG_HOME/gmail-attachments-mcp/token.json.

GMAIL_MCP_DEFAULT_DEST_DIR(file)

Default directory where downloaded attachments are saved when the tool call does not specify dest_dir. Default: ~/Downloads.

GMAIL_MCP_SCOPES(str)

Comma-separated Google OAuth scopes. Default: https://www.googleapis.com/auth/gmail.readonly.