Skip to content
MCP server

Google Gmail

MCP server that lets AI clients list, read and send Gmail messages

Install
Pricing
Open source
Platforms
API, self-hosted
Runs
Remotely
Version
2.0.0
Listing updated
today

Similar MCP servers

About Google Gmail

Google Gmail is an open-source MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

The README says this connector is one of the Google connectors in the magoneai-mcp collection, a set of MCP servers that wrap third-party APIs and run with your own credentials. The Gmail connector is registered with the MCP Registry under the description "List, read and send Gmail messages", so reading mail and sending mail are the two jobs it is documented to cover.

The server speaks MCP over Streamable HTTP on port 8000 and ships as a Docker image. Its default auth mode, platform, expects a shared secret sent as the X-Service-Token header. Hosted and local modes need additional settings that the repository documents separately. Because the README notes that a tool's credentials can come from headers or a credentials file, you supply your own Google access rather than relying on a vendor-hosted account.

The package is aimed at developers and teams who want an AI agent or MCP host to work with a mailbox, and who want to run the connector on their own infrastructure. Tool-level details are listed in the repository's generated tools document rather than in the registry entry.

Install

Run in a terminal

claude mcp add google-gmail --env MCP_SERVICE_TOKEN='<MCP_SERVICE_TOKEN>' -- docker run -i --rm -e MCP_SERVICE_TOKEN docker.io/magureai/mcp-google-gmail:2.0.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-gmail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SERVICE_TOKEN",
        "docker.io/magureai/mcp-google-gmail:2.0.0"
      ],
      "env": {
        "MCP_SERVICE_TOKEN": "<MCP_SERVICE_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-gmail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SERVICE_TOKEN",
        "docker.io/magureai/mcp-google-gmail:2.0.0"
      ],
      "env": {
        "MCP_SERVICE_TOKEN": "<MCP_SERVICE_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "google-gmail": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SERVICE_TOKEN",
        "docker.io/magureai/mcp-google-gmail:2.0.0"
      ],
      "env": {
        "MCP_SERVICE_TOKEN": "<MCP_SERVICE_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-gmail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SERVICE_TOKEN",
        "docker.io/magureai/mcp-google-gmail:2.0.0"
      ],
      "env": {
        "MCP_SERVICE_TOKEN": "<MCP_SERVICE_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "google-gmail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SERVICE_TOKEN",
        "docker.io/magureai/mcp-google-gmail:2.0.0"
      ],
      "env": {
        "MCP_SERVICE_TOKEN": "<MCP_SERVICE_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MCP_MODEAuth mode. The image defaults to platform; hosted and local need more settings, see docs/configuration.md.
  • MCP_SERVICE_TOKENShared secret callers send as X-Service-Token in platform mode.

What it does

Gmail message listing
Lists messages from a Gmail account through an MCP tool call.
Gmail message reading
Reads the content of individual Gmail messages for an AI client.
Gmail message sending
Sends email through the connected Gmail account from an MCP client.
Streamable HTTP transport
Serves MCP over Streamable HTTP at a /mcp endpoint with a health check.
Docker image deployment
Published as a container image that runs the connector without a local Python setup.
Authentication modes
Platform mode requires a shared service token; hosted and local modes are configurable.

Good for

  • Letting an AI assistant summarise unread messages in a Gmail inbox
  • Drafting and sending routine replies from an agent workflow
  • Pulling specific email threads into a document or CRM process
  • Building an internal automation that reads order or support emails

Pricing

Open source

Free, open-source Apache-2.0 connector; runs on your own infrastructure.

More servers for the same service

Google Gmail FAQ

What transport does the server use?

It speaks MCP over Streamable HTTP at http://localhost:8000/mcp by default, and the README says there is no stdio transport yet.

How is the server authenticated by default?

The default MCP_MODE is platform, which expects the caller to send the secret in MCP_SERVICE_TOKEN as an X-Service-Token header.

Is the connector open source?

The README states the repository is licensed under Apache-2.0.

Is Google Gmail free?

Yes. Google Gmail is open source, so you can use and self-host it for free.

How do I add Google Gmail to Claude Code?

Run this command in your terminal: claude mcp add google-gmail --env MCP_SERVICE_TOKEN='<MCP_SERVICE_TOKEN>' -- docker run -i --rm -e MCP_SERVICE_TOKEN docker.io/magureai/mcp-google-gmail:2.0.0

What are the best alternatives to Google Gmail?

The closest alternatives to Google Gmail are Gws Connector, mailmcp, Google Chat MCP, MCP Server and Google Workspace MCP.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers