Gmail-mcp-server

Name: Gmail-mcp-server
Author: MaitreyaM

@MaitreyaM

Repository

About Gmail-mcp-server

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

Basic information

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

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.