# Gmail

> Gmail is a freemium MCP server for communication. MCP server that lets AI clients read, search, send and label Gmail via OAuth. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, vscode, Web
- **Website:** https://pipeworx.io/packs/gmail
- **Repository:** https://github.com/pipeworx-io/mcp-gmail
- **MCP Registry name:** io.github.pipeworx-io/gmail
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

The README describes this as a Pipeworx gateway pack, so requests pass through a hosted endpoint at gateway.pipeworx.io rather than straight to Google. Once an account is connected, an AI client can list inbox messages, fetch full message details including headers, body, attachments and labels, run Gmail query-syntax searches, send mail with CC, BCC, reply-to and attachments, and list system and custom labels.

The pack can be reached over streamable HTTP or through a local npm stdio bridge (@pipeworx/mcp-gmail) that forwards calls to the same endpoint. Calls work anonymously at a daily cap, and a free Pipeworx key raises the limit. The README notes that the endpoint also lists shared gateway meta-tools such as ask_pipeworx alongside the five Gmail tools.

This suits developers and power users who want an agent to triage or draft mail from a Gmail account and are comfortable routing that access through a third-party gateway. The project describes itself as an independent, unofficial integration.

## Features

- **Inbox listing:** Lists inbox messages with optional filtering by label or read status, returning IDs and preview text.
- **Full message retrieval:** Fetches headers, subject, body, sender, recipients, attachments and labels for a given message ID.
- **Gmail query search:** Runs searches using Gmail query syntax such as sender, subject, attachment and date filters.
- **Send with attachments:** Sends email with CC, BCC, reply-to and file attachments.
- **Label management:** Returns system folders and custom labels with their IDs for filtering or organising mail.

## Good for

- Triage an inbox from an AI assistant by listing unread or labelled messages
- Find invoices or messages with attachments using Gmail search syntax
- Draft and send follow-up emails from within an MCP-enabled chat client
- Look up label IDs before filing or filtering messages

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http gmail https://gateway.pipeworx.io/gmail/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/gmail/mcp
```

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

```json
{
  "mcpServers": {
    "gmail": {
      "url": "https://gateway.pipeworx.io/gmail/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "gmail": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/gmail/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gateway.pipeworx.io/gmail/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gmail": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/gmail/mcp"
    }
  }
}
```

## Tools

- `gmail_list_messages`: List messages in your inbox with optional filtering by label or read status.
- `gmail_get_message`: Fetch full email details by message ID.
- `gmail_search`: Search emails using Gmail query syntax.
- `gmail_send`: Send an email with recipient, subject, and body text, with optional CC, BCC, reply-to and attachments.
- `gmail_list_labels`: Get all labels including system folders and custom labels.

## FAQ

### Do I need an API key to use it?

No. The README says calls run anonymously capped at 50 a day. A free Pipeworx account raises the cap to 200 a day, and an optional PIPEWORX_API_KEY can be set for the npm bridge.

### Which Gmail tools are included?

Five tools: gmail_list_messages, gmail_get_message, gmail_search, gmail_send and gmail_list_labels.

### Which clients can connect?

The website lists Claude.ai as a custom connector, Claude Desktop and Claude Code via mcp-remote, and Cursor and VS Code one-click installs, with a note on minimum versions.

### Is it affiliated with Google?

No. The README says it is an independent, unofficial integration and not affiliated with or endorsed by the upstream provider.

### Is Gmail free?

Gmail has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Gmail to Claude Code?

Run this command in your terminal: claude mcp add --transport http gmail https://gateway.pipeworx.io/gmail/mcp

### What are the best alternatives to Gmail?

The closest alternatives to Gmail are Google Gmail, mcp4mail, MCPEmails, inboxmcp and Gws Connector.

## Where this comes from

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

## Alternatives

- [Google Gmail](https://ai-powered.com/mcp/google-gmail-2): Google Gmail is an open-source MCP server for communication.
- [mcp4mail](https://ai-powered.com/mcp/mcp4mail): mcp4mail is an open-source MCP server for communication.
- [MCPEmails](https://ai-powered.com/mcp/mcpemails): MCPEmails is a freemium MCP server for communication.
- [inboxmcp](https://ai-powered.com/mcp/inboxmcp-2): inboxmcp is a freemium MCP server for communication.
- [Gws Connector](https://ai-powered.com/mcp/gws-connector): Gws Connector is an open-source MCP server for productivity.
- [Mails.ai — Agent Email](https://ai-powered.com/mcp/mails-ai-agent-email): Mails.ai — Agent Email is a freemium MCP server for communication.
- [MCP Server](https://ai-powered.com/mcp/mcp-server-mwenf0i2): MCP Server is a freemium MCP server for communication.
- [Missive MCP by usefulapi](https://ai-powered.com/mcp/missive-mcp-by-usefulapi): Missive MCP by usefulapi is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/gmail-5
