Gmail MCP Server Logo

About Gmail MCP Server

Gmail MCP Server is a Model Context Protocol server that connects AI assistants to Gmail, enabling natural-language email management directly from tools like Claude Desktop, Cursor, and other MCP-compatible clients. It provides tools for sending emails (plain text, HTML, and multipart with attachments), searching your inbox using Gmail search syntax, reading message contents, and managing labels to organize or archive messages. The server supports OAuth 2.0 authentication through Google's API, with credentials stored securely in your local environment. Features include reply threading so responses appear in the correct conversation, send-as alias support for accounts with multiple sending addresses, and attachment downloading to your local filesystem. You can search emails using the same operators available in Gmail's search bar, from, to, subject, has:attachment, after, before, and more, giving AI agents precise control over email retrieval. Several implementations exist in the community, from the popular GongRzhe version with auto-authentication to the Google Workspace MCP that bundles Gmail with Calendar, Drive, Sheets, and Docs in a single server. The headless variant removes the need for local credential setup entirely by using a dedicated token refresh tool. Gmail MCP Server is open source, typically distributed as a Python or Node.js package, and works well for automating email triage, drafting responses, extracting information from messages, and managing inbox organization through AI.