Gmail-mcp-server

What is Gmail-mcp-server?

A resilient MCP server built with fastMCP that sends emails via Gmail’s SMTP server, designed for AI agents to send emails with attachments using direct file paths, URLs, or pre-staged files.

How to use Gmail-mcp-server?

Set up environment variables (SMTP_USERNAME and SMTP_PASSWORD) in a .env file, then run python server.py. Alternatively, install automatically via Smithery for Claude Desktop. Use the send_email_tool with parameters recipient, subject, body, and optionally attachment_path, attachment_url, and attachment_name.

Key features of Gmail-mcp-server

• Gmail SMTP integration with TLS support
• Multiple attachment methods: file path, URL, pre-staged
• Increased timeout and graceful shutdown handling
• Environment-based credential configuration
• Installable via Smithery for Claude Desktop

Use cases of Gmail-mcp-server

• Sending emails with attachments directly from an AI agent
• Automating email notifications with files from local storage
• Downloading a file from a public URL and attaching it in one step
• Using a dedicated directory for frequently used attachments

FAQ from Gmail-mcp-server

What are the prerequisites?

Python 3.x, the mcp, python-dotenv, and requests packages, and a Gmail account with SMTP enabled and an App Password (required if 2‑Step Verification is on).

How do I configure Gmail credentials?

Set SMTP_USERNAME (your full Gmail address) and SMTP_PASSWORD (your App Password) in a .env file in the project root.

Which attachment methods are supported?

Three: a direct local file path, a public URL from which the file is downloaded, or a file placed in the available_attachments directory (referenced by attachment_name).

How do I run the server?

Execute python server.py from the project directory, or use npx -y @smithery/cli install @MaitreyaM/gmail-mcp-server --client claude for automated installation.

Where does the server store downloaded files?

Downloaded files are saved to a temp_attachments directory created automatically by the server.