# Google Gmail

> Google Gmail is an open-source MCP server for communication. MCP server that lets AI clients list, read and send Gmail messages. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted
- **Repository:** https://github.com/magurelabs/magoneai-mcp/tree/HEAD/connectors/google_gmail
- **MCP Registry name:** io.github.magurelabs/google-gmail
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

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

## Alternatives

- [Gws Connector](https://ai-powered.com/mcp/gws-connector): Gws Connector is an open-source MCP server for productivity.
- [mailmcp](https://ai-powered.com/mcp/mailmcp): mailmcp is a freemium MCP server for communication.
- [Google Chat MCP](https://ai-powered.com/mcp/google-chat-mcp): Google Chat MCP is an open-source MCP server for communication.
- [MCP Server](https://ai-powered.com/mcp/mcp-server-mwenf0i2): MCP Server is a freemium MCP server for communication.
- [Google Workspace MCP](https://ai-powered.com/mcp/google-workspace-mcp): Google Workspace MCP is an open-source MCP server for productivity.
- [mcp4mail](https://ai-powered.com/mcp/mcp4mail): mcp4mail is an open-source MCP server for communication.
- [Mailgi](https://ai-powered.com/mcp/mailgi): Mailgi is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/google-gmail-2
