AI导哈

Gmail自动化工具

通过Chrome扩展和模型上下文协议，实现AI助手对Gmail的自动化操作，无需Google API密钥。

  • by cafferychen777
  • JavaScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 cafferychen777/gmail-mcp

使用说明

Gmail MCP网桥

英语| 中文文档 README.zh-CN.md

从Claude控制Gmail。没有谷歌云。没有OAuth。没有API密钥。

通过Chrome扩展程序和模型上下文协议为AI助手启用Gmail自动化。在本地工作，尊重您的浏览器会话，不需要Google API密钥。

如果这个项目对你有帮助，请⭐ 签署回购协议并加入 讨论.

⚡️ 大胆的优势：没有谷歌云项目。没有OAuth同意屏幕。没有API密钥。它使用您现有的Chrome会话在Gmail中运行。

为什么没有谷歌云

此项目通过利用您现有的Chrome浏览器会话在本地工作。扩展和MCP服务器在Gmail上的作用与您在浏览器中的作用相同，因此您不需要设置Google Cloud项目、OAuth同意屏幕或任何API密钥。

优点：

  • 更简单的入门：没有云控制台，没有OAuth应用程序审查。
  • 隐私：操作将保留在您的本地浏览器会话中。
  • 可移植性：适用于Chrome运行的任何地方。

需要注意的限制：

  • 需要安装Chrome并登录到目标Gmail帐户。
  • 操作遵循您当前Gmail会话的权限。

⚡ 安装

有关指导设置，请参阅快速入门和网站：

先决条件：

  • Node.js 18+
  • 谷歌Chrome浏览器（最新）
  • 克劳德桌面（启用MCP）
# One-command install (recommended)
./bin/gmail-mcp install

# Or manual setup
cd gmail-mcp-extension/mcp-server && npm install

📁 项目结构

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

🚀 特性

  • Gmail阅读/搜索/发送/回复
  • 完整的Gmail搜索语法支持
  • 多账户切换
  • 自动恢复（95%以上常见故障）
  • 自诊断和维修工具
  • 低延迟、高吞吐量的本地网桥

🎯 用法

CLI管理

gmail-mcp status    # Check system status
gmail-mcp doctor    # Diagnose issues
gmail-mcp fix       # Auto-fix common problems
gmail-mcp test      # Run tests

在克劳德桌面

安装完成后，只需询问Claude：

  • “查看我的最新电子邮件”
  • “发送电子邮件至john@example.com"
  • “搜索包含“项目”的电子邮件”

📚 文档

🎬 演示/截图

下面是占位符截图；很快就会添加一个简短的演示GIF。

计划： docs/assets/screenshots/demo.gif （≤10s）。

如果你想帮忙，先检查一下好的问题。

🏆 为什么这个项目

  • 无API密钥，可直接与浏览器会话配合使用
  • 用于AI助手的MCP快速本地网桥
  • 具有安装程序和诊断功能的生产就绪结构

🔗 社交预览（Open Graph）

通过上传社交图片来改善共享仓库时的链接预览：

  1. 使用占位符 docs/assets/images/og-preview.svg （如有需要，可导出为1200×630 PNG）
  2. 转到GitHub→ 存储库设置→ 将军→ 社交预览→ 上传图片

🤝 贡献

PR欢迎！请阅读 贡献.md.

📄 许可证

MIT许可证——见 许可证

Gmail MCP桥——通过MCP从克劳德桌面控制Gmail🚀

🧭 社区与支持

  • 行为准则： 代码_OF_CONDUCT.md
  • 安全策略： 安全.md
  • 技术支持： 支持.md
  • 讨论：https://github.com/cafferychen777/gmail-mcp/discussions
  • 好的第一个问题：https://github.com/cafferychen777/gmail-mcp/labels/good-first-issue
  • 需要帮助：https://github.com/cafferychen777/gmail-mcp/labels/help-wanted

相关 MCP