MCP server for Gmail — send, search, read emails, manage drafts and labels via Google OAuth2.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"workos-gmail-mcp-server","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Gmail MCP Server <!-- mcp-name: io.github.workos/gmail-mcp-server --> A production-ready [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for Gmail operations. Connect any AI agent to Gmail — send emails, search your inbox, manage drafts, organize with labels, reply to threads, and more. **This is an independent, generalized MCP server.** It is not tied to any specific project and can be connected to any AI agent that supports MCP (Claude Desktop, Cursor, WorkOS, or custom agents). ## Features - 📨 **Send & Reply**: Compose emails, reply to threads, with CC support - 📥 **Read Inbox**: Fetch emails from any label (INBOX, SENT, STARRED, etc.) - 🔍 **Search**: Full Gmail query syntax (`from:`, `subject:`, `has:attachment`, etc.) - 📝 **Drafts**: Create, list, and send drafts - 🏷️ **Labels**: List, add, and remove labels on messages - 🧵 **Threads**: View full conversation threads - ✅ **Read/Unread**: Mark messages as read or unread ## Installation **Recommended — no pre-install required (uses [uv](https://docs.astral.sh/uv/)):** ```bash # uv manages a temporary isolated environment automatically uvx --from workos-gmail-mcp-server gmail-mcp-server ``` **Or install permanently with pip:** ```bash pip install workos-gmail-mcp-server ``` **Or install from source:** ```bash git clone https://github.com/workos/workos-gmail-mcp-server cd workos-gmail-mcp-server pip install -e . ``` ## Quick Start ```bash export GOOGLE_CLIENT_ID="your-client-id.apps.googleusercontent.com" export GOOGLE_CLIENT_SECRET="GOCSPX-your-secret" export GOOGLE_REFRESH_TOKEN="1//your-refresh-token" # Recommended: run via uvx (no install needed) uvx --from workos-gmail-mcp-server gmail-mcp-server # Or if installed via pip gmail-mcp-server # Or run as a Python module python -m gmail_mcp_server ``` ## Configuration ### Environment Variables | Variable | Required | Description | |----------|----------|-------------| | `GOOGLE_CLIENT_ID` | ✅ Yes | OAuth2 Client ID …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.