Gmail-mcp-server
@MaitreyaM
A resilient MCP server built with fastMCP for sending emails through Gmail's SMTP server using AI agents.
Overview
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.
