SkillAgentSearch skills...

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-mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

77/100

Category

Automation

Supported Platforms

Claude Code
Claude Desktop

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.

Substance
29/30
Structure
18/20
Description
15/15
Adoption
4/20
Freshness
11/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
gmail-mcp (this skill)by cafferychen77777108mo agoMCP Server
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.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.

Gmail MCP Bridge

English | 中文文档 README.zh-CN.md

Control Gmail from Claude. No Google Cloud. No OAuth. No API keys.

License: MIT Chrome Extension MCP Compatible Status: Production Ready GitHub Repo stars Website GitHub release (latest SemVer) PRs Welcome Discussions Contributors Good first issues Open issues Open PRs No Google Cloud / OAuth

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:

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

🎬 Demo / Screenshots

Below are placeholder screenshots; a short demo GIF will be added soon.

Install

Claude command triggering Gmail tools

Gmail action executed

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:

  1. Use the placeholder at docs/assets/images/og-preview.svg (export to 1200×630 PNG if needed)
  2. 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

View on GitHub
GitHub Stars10
CategoryAutomation
Updated7mo ago
Forks6

Languages

JavaScript

Trust signals

91/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low1 info