An MCP server that lets AI agents search Gmail threads, understand your email writing style, and create draft emails.
gmail-mcp-server is an MCP project maintained in the paulfidika/gmail-mcp-server repository. The maintainer describes its purpose as “An MCP server that lets AI agents search Gmail threads, understand your email writing style, and create draft emails”. Read the project documentation for the complete scope.
The project provides a local client configuration using C:/path/to/your/auto-gmail.exe. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET, OPENAI_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| search_threads | Search Gmail with queries like "from:email@example.com" or "subject:meeting" (includes draft info) |
| create_draft | Create email drafts or update existing drafts (AI will request style guide first) |
| extract_attachment_by_filename | Safely extract text from PDF, DOCX, and TXT attachments using filename |
| get_personal_email_style_guide | Get your email writing style guide (this is a temporary tool, created because most agents do not yet support fetching resources--once agents implement MCP… |
| file | //personal-email-style-guide - Your personal email writing style (auto-generated or manual) |
{
"mcpServers": {
"gmail": {
"command": "C:/path/to/your/auto-gmail.exe",
"env": {
"GMAIL_CLIENT_ID": "your_client_id_here.apps.googleusercontent.com",
"GMAIL_CLIENT_SECRET": "YOUR_GMAIL_CLIENT_SECRET",
"OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| GMAIL_CLIENT_ID | Declared in the maintainer’s client configuration. | Check documentation |
| GMAIL_CLIENT_SECRET | Declared in the maintainer’s client configuration. | Check documentation |
| OPENAI_API_KEY | Declared in the maintainer’s client configuration. | Check documentation |
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
Inbox intelligence — search, read, draft and send Gmail through your assistant with OAuth auto-setup.
Read and write Jira, Confluence, Bitbucket, JSM and Compass from your AI client — with your own permissions.
Read and send Telegram messages through your assistant — chats, channels and history via the client API.
Enables Discord bot integration with Model Context Protocol (MCP) compatible applications like Claude Desktop.