Gmail-mcp-server

@MaitreyaM

About Gmail-mcp-server

A resilient MCP server built with fastMCP for sending emails through Gmail's SMTP server using AI agents.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gmail-mcp-server-maitreyam": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@MaitreyaM/gmail-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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.

Frequently asked questions

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.

Comments

Basic information

More Communication MCP servers

Email sending MCP 💌

resend

The official MCP server to send emails and interact with Resend

549

Socialync

Jack Vitick

Draft, schedule, and publish social media posts to 8 platforms from any AI agent: Facebook, Instagram, X, TikTok, YouTube, LinkedIn, Threads, and Bluesky. 19 tools covering drafting, scheduling, publishing, media upload,