mcpField
G
Gmail-mcp-server

Gmail-mcp-server

Local
github.com/MaitreyaMCommunication10Updated 46w ago
Repository

About Gmail-mcp-server

Gmail-mcp-server is an MCP server for sending and retrieving email through Gmail SMTP, intended for AI agent workflows. It also handles attachments and provides a deployment health-check endpoint.

Key features

  1. 01Send email through Gmail SMTP
  2. 02Fetch recent folder messages
  3. 03Handle email attachments
  4. 04Provide a health-check endpoint

Use cases

  1. 01Have an AI agent send email
  2. 02Review recent messages in Gmail folders
  3. 03Send messages with attachments
  4. 04Monitor deployment health

MCP support

It exposes Gmail email sending, recent-message retrieval, and attachment handling to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "gmail-mcp-server-maitreyam": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Gmail-mcp-server

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

Features

  • Send emails via Gmail SMTP
  • Fetch recent emails from Gmail folders
  • Handle email attachments
  • Health check endpoint for deployment monitoring

Deployment on Smithery.ai

This server is configured for deployment on Smithery.ai using Streamable HTTP transport.

Configuration

The server requires the following configuration parameters:

  • smtp_username: Your Gmail email address
  • smtp_password: Your Gmail app password (not your regular password)
Health Check

The server provides a health check endpoint at /health for Smithery deployment monitoring.

CLAUDE CONFIG EXAMPLE

{
  "mcpServers": {
    "terminal_server": {
      "command": "/Users/maitreyamishra/.local/bin/uv",
      "args": [
        "--directory", "Path to your mcp server file",
        "run",
        "terminal_server.py"
      ]
    },
    "web3_server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:3000/mcp"
      ]
    },
    "gmail_mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8989/mcp"
      ]
    }
  }
}
Port

The server runs on port 5000 and binds to all interfaces (0.0.0.0) for container deployment.

Local Development

  1. Install dependencies:

    pip install -r requirements.txt

  2. Set environment variables:

    export SMTP_USERNAME="[email protected]"
export SMTP_PASSWORD="your-app-password"

  3. Run the server:

    python gmail_mcp.py

Docker

Build and run with Docker:

docker build -t gmail-mcp .
docker run -p 5000:5000 -e SMTP_USERNAME=your-email -e SMTP_PASSWORD=your-password gmail-mcp

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.