
Gmail
MCP server that lets AI clients read, search, send and label Gmail via OAuth
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/gmail/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"gmail": {
"url": "https://gateway.pipeworx.io/gmail/mcp"
}
}
}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.