Skip to content
MCP server

Gmail

MCP server that lets AI clients read, search, send and label Gmail via OAuth

Install
Pricing
Freemium
Platforms
API, CLI, vscode
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Gmail

Gmail is a freemium MCP server for communication. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/gmail/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gmail": {
      "url": "https://gateway.pipeworx.io/gmail/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

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

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Free anonymous and free registered tiers; paid credits and subscriptions for higher usage

Prices change. Check pipeworx.io before you buy.

More servers for the same service

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

How AIPoweredBot checks servers