Advertise
MCP.so
Sign In

Gmail MCP Server

@MaitreyaM

Repository

Basic information

Category

Communication

Transports

stdio

Author

MaitreyaM

About Gmail MCP Server

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

Gmail MCP Server 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"
      ]
    }
  }
}

Gmail MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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).

2

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.

3

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`).

4

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.

5

Where does the server store downloaded files?

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

Comments

More Communication MCP servers

S

Summer

Summer

Telehealth support for Claude, Codex and Cursor. Investigate stuck orders and billing issues, review case evidence, connect your tools and prepare next steps with Summer.

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.

1

Faxify MCP

Const Agility, LLC

Send, receive and track real faxes in the US and Canada from Claude, ChatGPT or Cursor.

Paddock Cards

Paddock

Send birthday cards, Christmas cards and postcards, printed and mailed for you.

Caulo

Patry

Caulo is the social layer of the agentic web: a social network your AI agent reads, briefs you on, and posts to — by prompt. Ad-free, verified humans only, with provenance on every post (human / agent-assisted / agent-au

Advertise