gmail-mcp
Gmail automation via a Chrome extension + Model Context Protocol (MCP). Control Gmail from Claude Desktop. No API keys. Free.
Install / Use
claude mcp add cafferychen777 -- npx -y github:cafferychen777/gmail-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AutomationSupported Platforms
Tags
Our assessment of gmail-mcp
gmail-mcp scores 77/100 on our quality scale, 2537th of 2,790 Automation skills we index.
Its MCP Server is 6.6 KB long, well organised into 17 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 8 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 91/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-14. Automated pattern scan on 2026-11-14. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
gmail-mcp compared with similar skills
All 4 of these similar skills score higher than gmail-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| gmail-mcp (this skill)by cafferychen777 | 77 | 10 | 8mo ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install gmail-mcp?
- Run
claude mcp add cafferychen777 -- npx -y github:cafferychen777/gmail-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does gmail-mcp work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is gmail-mcp safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 91/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is gmail-mcp still maintained?
- The repository was last updated about 8 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubGmail MCP Bridge
English | 中文文档 README.zh-CN.md
Control Gmail from Claude. No Google Cloud. No OAuth. No API keys.
Enable Gmail automation for AI assistants through a Chrome extension and the Model Context Protocol. Works locally, respects your browser session, and requires no Google API keys.
If this project helps you, please ⭐ star the repo and join the Discussions.
⚡️ Bold advantage: No Google Cloud project. No OAuth consent screen. No API keys. It uses your existing Chrome session to act in Gmail.
Why no Google Cloud
This project works locally by leveraging your existing Chrome browser session. The extension and MCP server act on Gmail the same way you do in the browser, so you do not need to set up a Google Cloud project, OAuth consent screen, or any API keys.
Benefits:
- Simpler onboarding: no cloud console, no OAuth app review.
- Privacy: actions stay within your local browser session.
- Portability: works anywhere Chrome runs.
Limitations to note:
- Requires Chrome to be installed and signed in to the target Gmail account.
- Actions follow the permissions of your current Gmail session.
⚡ Installation
For a guided setup, see the Quick Start and Website:
- Quick Start: docs/quick-start/installation.md
- Website: https://cafferychen777.github.io/gmail-mcp/
Prerequisites:
- Node.js 18+
- Google Chrome (latest)
- Claude Desktop (with MCP enabled)
# One-command install (recommended)
./bin/gmail-mcp install
# Or manual setup
cd gmail-mcp-extension/mcp-server && npm install
📁 Project Structure
gmail-mcp/
├── bin/ # CLI utilities (installer/manager)
│ └── gmail-mcp
├── gmail-mcp-extension/ # Chrome Extension + MCP bridge server
│ ├── extension/ # Chrome extension source
│ ├── mcp-server/ # MCP bridge server
│ └── src/ # Core logic and recovery system
├── docs/ # Documentation
│ ├── planning/
│ ├── reports/
│ └── analysis/
├── scripts/ # Tooling scripts
│ ├── test/
│ └── util/
├── src/ # Advanced features
│ ├── core/
│ └── plugins/
├── tests/
├── tools/
└── Key docs
├── README.md
├── README.zh-CN.md
├── CLAUDE.md
├── CONTRIBUTING.md
└── RELEASE.md
🚀 Features
- Gmail read/search/send/reply
- Full Gmail search syntax support
- Multi-account switching
- Auto-recovery (95%+ common failures)
- Self-diagnosis and repair utilities
- Low-latency, high-throughput local bridge
🎯 Usage
CLI management
gmail-mcp status # Check system status
gmail-mcp doctor # Diagnose issues
gmail-mcp fix # Auto-fix common problems
gmail-mcp test # Run tests
In Claude Desktop
After installation, just ask Claude:
- "Check my latest emails"
- "Send an email to john@example.com"
- "Search emails containing 'project'"
📚 Documentation
- Developer architecture: docs/developer/architecture.md
- Roadmap: docs/planning/COMPREHENSIVE_IMPROVEMENT_ROADMAP.md
- Contribution guide: CONTRIBUTING.md
🎬 Demo / Screenshots
Below are placeholder screenshots; a short demo GIF will be added soon.
Planned: docs/assets/screenshots/demo.gif (≤10s).
If you'd like to help, check the good first issues.
🏆 Why this project
- No API keys, works directly with your browser session
- Fast local bridge with MCP for AI assistants
- Production-ready structure with installer and diagnostics
🔗 Social preview (Open Graph)
Improve link previews when sharing the repo by uploading a social image:
- Use the placeholder at
docs/assets/images/og-preview.svg(export to 1200×630 PNG if needed) - Go to GitHub → Repository Settings → General → Social preview → Upload the image
🤝 Contributing
PRs welcome! Please read CONTRIBUTING.md.
📄 License
MIT License — see LICENSE
Gmail MCP Bridge — Control Gmail from Claude Desktop via MCP 🚀
🧭 Community & Support
- Code of Conduct: CODE_OF_CONDUCT.md
- Security policy: SECURITY.md
- Support: SUPPORT.md
- Discussions: https://github.com/cafferychen777/gmail-mcp/discussions
- Good first issues: https://github.com/cafferychen777/gmail-mcp/labels/good-first-issue
- Help wanted: https://github.com/cafferychen777/gmail-mcp/labels/help-wanted
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
