Gmail-attachments-mcp Server

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

Local serverstdio

What is the Gmail-attachments-mcp Server?

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

Packages and local setup

The published pypi package is gmail-attachments-mcp, version 0.1.0. Its declared MCP transport is stdio.

The package declares 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..

This package has launch arguments in its registry record. Use the maintainer’s configuration for those arguments rather than launching it with only the package name.

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.1.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related communication MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
GMAIL_MCP_CREDENTIALSPath to the Google OAuth client secret JSON. Default: $XDG_CONFIG_HOME/gmail-attachments-mcp/credentials.json.Optional
GMAIL_MCP_TOKENPath to the cached Gmail OAuth refresh token. Default: $XDG_CONFIG_HOME/gmail-attachments-mcp/token.json.Optional
GMAIL_MCP_DEFAULT_DEST_DIRDefault directory where downloaded attachments are saved when the tool call does not specify dest_dir. Default: ~/Downloads.Optional
GMAIL_MCP_SCOPESComma-separated Google OAuth scopes. Default: https://www.googleapis.com/auth/gmail.readonly.Optional