Overview
honest-gmail-mcp is a local Gmail MCP server that enables AI assistants to interact with Gmail without routing emails through a third-party server. It runs on the user's machine, authenticates directly to the Google Gmail API using the user's OAuth credentials, and exposes six tools to a local AI client such as Claude Code or Claude Desktop over stdio.
The project addresses a privacy concern with most Gmail integrations for AI assistants, which route emails through a third-party server, exposing plaintext of every message. This server avoids that by keeping the data flow directly between the user's machine and Google.
The server provides six tools: search_messages, get_message, send_message, create_draft, list_labels, and modify_labels. It supports sending emails with local file attachments and proper in-thread replies.
The server is a single Python file of a few hundred lines, allowing users to audit the code. Credentials and tokens are stored locally and are gitignored.
Pricing
Free
Detailed plans have not been confirmed in our catalog. Check the official website for current limits and billing terms.
Visit WebsitePrices and limits may change. Confirm the currency, billing period, seat minimum and usage caps on the official website.
Use Cases
- Users use honest-gmail-mcp to search Gmail messages using Gmail search syntax.
- Users use honest-gmail-mcp to read full message headers and decoded text/plain body.
- Users use honest-gmail-mcp to send emails with local file attachments.
- Users use honest-gmail-mcp to create email drafts without sending them.
- Users use honest-gmail-mcp to list all Gmail labels with their IDs.
- Users use honest-gmail-mcp to modify labels on messages by adding or removing them.
Features
Run a local MCP server
Send emails through Gmail
Search Gmail messages
Apply Gmail labels
Keep data between your machine and Google
Reviews
No reviews yet. Be the first to share your experience!