谷歌邮箱 mcp
cafferychen777/gmail-mcp
1 Stars
513 次浏览
更新于 2026-08-23
基于浏览器扩展的Gmail集成，适用于Claude Desktop及其他兼容MCP的人工智能助手，无需API密钥或费用。
该服务暂未提供标准配置，请参考 README 手动接入
服务介绍
Gmail MCP Bridge
一个基于浏览器扩展的Gmail集成，适用于Claude Desktop和其他MCP兼容的AI助手，无需API密钥或费用。
🎉 项目状态：所有模块已完成并完全可用！
Gmail MCP Bridge现已准备好投入生产，所有核心功能均已实现并经过测试。
🎯 为什么选择Gmail MCP Bridge？
现有解决方案的问题
官方Gmail MCP实现的限制：
- ❌ 只能读取邮件（没有发送能力）
- ❌ 需要复杂的Google Cloud设置
- ❌ 需要OAuth2认证流程
第三方Gmail API实现：
- 💰 需要付费的Google Cloud Platform账户
- 🔐 许多教育/机构账户阻止Gmail API访问
- 📝 复杂的API密钥管理和配额
我们的解决方案
Gmail MCP Bridge使用浏览器扩展方法，具有以下特点：
- ✅ 支持任何Gmail账户（个人、教育、企业）
- ✅ 无需API密钥、OAuth或Google Cloud设置
- ✅ 完全免费 - 无API配额或费用
- ✅ 全面功能：读取、发送、回复和搜索邮件
- ✅ 直接与您已使用的Gmail界面配合工作
- ✅ 注重隐私：所有数据仅在您的浏览器和Claude之间本地传输
✨ 功能
- 📧 列出Gmail收件箱中的邮件
- 📖 阅读带有完整格式的邮件内容
- ✍️ 撰写新邮件，自动填充收件人、主题和内容
- 💬 回复邮件，智能插入内容
- 🔍 使用Gmail强大的搜索语法搜索邮件
- 📎 处理附件（查看、下载）
- 🏷️ 将邮件标记为已读/未读
- 🗑️ 删除和归档邮件
- 👥 多账户支持，管理多个Gmail账户
- 🔄 与Gmail界面实时同步
🚀 快速开始
1. 安装依赖项
cd gmail-mcp-extension/mcp-server
npm install
2. 安装Chrome扩展程序
- 打开Chrome并导航到
chrome://extensions/ - 启用**“开发者模式”**（右上角切换）
- 点击**“加载已解压的扩展程序”**并选择
gmail-mcp-extension/extension文件夹 - 记下扩展程序ID（例如，
abcdefghijklmnopqrstuvwxyz）
3. 启动Bridge服务器
cd gmail-mcp-extension/mcp-server
npm run bridge
4. 配置Claude Desktop
将以下内容添加到您的Claude Desktop MCP配置中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"gmail-mcp": {
"command": "node",
"args": ["/absolute/path/to/gmail-mcp-extension/mcp-server/index.js"]
}
}
}
5. 开始使用
- 在Chrome中打开Gmail
- 重启Claude Desktop
- 询问Claude：“显示我最近的邮件”
📁 项目结构
gmail-mcp/
├── README.md # This file - project overview
├── CONTRIBUTING.md # Contribution guidelines
└── gmail-mcp-extension/ # Main implementation
├── README.md # Detailed documentation
├── SETUP.md # Complete setup guide
├── extension/ # Chrome extension
│ ├── manifest.json
│ ├── background.js
│ ├── content.js
│ └── popup.html
├── mcp-server/ # MCP server implementation
│ ├── index.js # Main MCP server
│ ├── bridge-server.js # HTTP bridge server
│ └── package.json
└── docs/ # Additional documentation
├── SEARCH_GUIDE.md
├── TESTING_GUIDE.md
└── MCP_USAGE.md
🔧 架构
Claude Desktop/Cherry Studio
↓ (MCP Protocol)
MCP Server (index.js)
↓ (HTTP Requests)
Bridge Server (bridge-server.js)
↓ (HTTP Polling)
Chrome Extension (background.js)
↓ (Content Script)
Gmail Web Interface
📖 文档
🎯 用例
与Claude Desktop结合使用
"Show me my recent emails"
"Search for emails from GitHub about pull requests"
"Send an email to alice@example.com saying I'll be 10 minutes late"
"Reply to the latest email from Bob with 'Thanks for the update!'"
"Mark all emails from newsletters as read"
"Archive emails older than 30 days"
多账户支持
"List all my Gmail accounts"
"Switch to my work email account"
"Send an email from my personal account"
"Search for project emails in my work account"
🛡️ 隐私与安全
- 数据不会离开您的设备 - 所有通信都在本地进行
- 不存储凭据 - 使用您现有的Gmail会话
- 开源 - 您可以自行审核代码
- 无跟踪或分析 - 您的邮件数据保持私密
🤝 贡献
我们欢迎贡献！请参阅我们的贡献指南以获取详细信息。### 开发环境设置
- 叉分（Fork）仓库
- 克隆你的叉分
- 遵循上述设置说明
- 进行你的修改
- 彻底测试
- 提交一个拉取请求
📄 许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。
🙏 致谢
- 使用 Model Context Protocol SDK 构建
- 灵感来源于对 AI 助手中易于访问的 Gmail 集成的需求
- 感谢 Claude Desktop 团队提供的 MCP 支持
📞 支持
- 问题: GitHub Issues
- 讨论: GitHub Discussions
- 文档: 项目 Wiki
为 AI 社区用心打造
