mcp gsuite增强版
适用于Google Workspace的全面MCP服务器，具有完整的Gmail API覆盖范围和高级电子邮件管理
](https://github.com/ajramos/mcp-gsuite-enhanced)  
MCP服务器与谷歌产品交互 完整的Gmail API覆盖范围 （共27个工具）、高级电子邮件管理、标签操作、归档工作流程和工作Google Meet集成。
目录
🚀 快速开始
让谷歌工作区MCP在5分钟内运行！
先决条件
- Python 3.13+和
uv安装 - 具有Gmail/日历访问权限的谷歌帐户
- Cursor IDE（推荐）或任何MCP客户端
步骤1：克隆并安装
git clone https://github.com/ajramos/mcp-gsuite-enhanced.git
cd mcp-gsuite-enhanced
uv sync步骤2：设置谷歌云（一次性设置）
- 首选 谷歌云控制台
- 创建项目并启用 Gmail API + 谷歌日历API
- 创建 OAuth 2.0桌面 凭证
- 下载并另存为
.gauth.json在项目目录中
步骤3：配置帐户
创建 .accounts.json:
{
"accounts": [
{
"email": "your-email@gmail.com",
"account_type": "personal",
"extra_info": "Main personal Gmail and Calendar"
}
]
}步骤4：快速配置检查
python cursor_setup.py这将显示身份验证状态并生成游标配置。
步骤5：身份验证
python auth_setup.py your-email@gmail.com打开浏览器进行OAuth流-授予权限，您就完成了！
步骤6：在游标中配置
- 从步骤4复制JSON配置
- 光标→ 设置（Cmd+，）→ 搜索“MCP”
- 粘贴配置并重新启动Cursor
第七步：测试一下！ 🎉
在Cursor中尝试以下命令：
- *“列出我的日历”*
- *“显示我的未读电子邮件”*
- *“使用Google Meet链接创建测试会议”*
就是这样！ 您现在可以完全集成Google Workspace和自动Google Meet链接！
______________________________________________________________________
🎯 增强功能v2.0.0
🚀 完整的Gmail API覆盖范围（共27个工具）
- 22个Gmail工具 -完整的电子邮件生命周期管理
- 5日历工具 -与Google Meet完全集成日历
✨ 高级电子邮件管理
- ✅ 发送电子邮件 直接通过Gmail
- ✅ 标签管理 -创建、应用、删除和删除标签
- ✅ 归档工作流程 -归档、恢复和管理电子邮件生命周期
- ✅ 草案管理 -列出、创建和管理电子邮件草稿
- ✅ 批量操作 -高效地存档多封电子邮件
- ✅ 电子邮件状态 -标记为已读/未读，移至垃圾箱
🎪 增强的日历功能
- ✅ 工作Google Meet集成 -日历事件中的自动会议链接
- ✅ 固定的
update_calendar_event-以前坏了，现在功能齐全 - ✅ 改进了与会者处理 -修复了电子邮件解析错误
- ✅ 设置实用程序 -
auth_setup.py和cursor_setup.py便于配置
特性和功能
v2.0.0提供了全面的谷歌工作区自动化，共有27个工具：
1.总则
- 支持多个Google帐户
- OAuth 2.0身份验证与令牌刷新
- 全面的错误处理和记录
2.Gmail（22个工具）📧
电子邮件管理
- 通过Gmail直接发送电子邮件，支持CC/BCC
- 通过灵活搜索（未读、发件人、日期、附件）查询电子邮件
- 按ID检索完整的电子邮件内容或一次检索多封电子邮件
- 将电子邮件标记为已读/未读
- 将电子邮件移至垃圾箱
草案管理
- 创建包含收件人、主题、正文和抄送选项的新电子邮件草稿
- 列出所有详细信息的电子邮件草稿
- 删除电子邮件草稿
- 回复现有电子邮件（立即发送或另存为草稿）
标签管理 🏷️
- 列出所有Gmail标签（系统+自定义）
- 创建新的自定义标签
- 为电子邮件添加标签
- 从电子邮件中删除标签
- 永久删除自定义标签
归档工作流 📁
- 存档个人电子邮件（从收件箱中删除）
- 一次归档多封电子邮件（批量操作）
- 列出已存档的电子邮件
- 将存档的电子邮件还原回收件箱
附件管理
- 下载电子邮件附件并将其保存到本地文件
- 批量保存来自不同电子邮件的多个附件
3.日历（5个工具）📅
- 列出您帐户的可用日历
- 获取指定时间范围内的日历事件
- 与与会者一起创建新的日历事件 自动Google Meet链接 🎪
- 更新现有日历事件 （摘要、时间、与会者）⚡
- 删除日历事件
- 国际日程安排的完整时区支持
💡 示例提示尝试
📧 Gmail操作（22个工具）
- 电子邮件搜索和检索
- *“检索我最近未读的邮件”* - *“搜索Scrum Master的电子邮件”* - *“显示本周所有带附件的电子邮件”* - *“获取有关ABC的电子邮件并对其进行总结”*
- 电子邮件撰写与管理
- *“发送电子邮件至john@company.com关于项目更新”* - *“为Alice的最后一封电子邮件写一个漂亮的回复，并另存为草稿”* - *“标记来自的所有电子邮件marketing@company.com如读“* - *“将该垃圾邮件移至垃圾箱”*
- 标签管理 🏷️
- *“创建一个名为‘Project Alpha’的标签，并将其应用于有关该项目的电子邮件”* - *“显示我的所有自定义标签”* - *“从昨天的电子邮件中删除“紧急”标签”* - *“删除未使用的“旧项目”标签”*
- 归档工作流 📁
- *“存档上周时事通讯中的所有电子邮件”* - *“显示我第三季度的存档电子邮件”* - *“将该重要电子邮件还原回我的收件箱”* - *“一次存档这5封电子邮件：\[电子邮件ID\]”*
- 附件管理
- *“从包含‘发票’的电子邮件中下载所有附件”* - *“保存来自的所有电子邮件的附件john@company.com本周”*
📅 日历管理
- 议程和日程安排
- *“我明天的议程上有什么？”* - *“查看我的私人帐户下周的家庭日程”* - *“我需要和蒂姆一起计划下周2小时的活动。建议一些时间段”*
- 使用Google Meet创建活动 🎪
- *“下周五与约翰创建一个会议，并包含一个谷歌会议链接”* - *“安排周四下午2点的客户拜访，并邀请john@company.com"* - *“创建一个团队，每周一上午9点与谷歌见面会见面”* - *“使用Google Meet链接创建明天下午3点的项目审查会议，并邀请整个团队”*
- 事件更新 ⚡ *（增强功能）*
- *“更新我下午3点的会议，让Sarah成为与会者”* - *“更新季度计划会议，将时间改为下午4点，并添加sarah@company.com"* - *“将明天的团队会议地点更改为会议室B”*
- 高级日历查询
- *“列出我下周所有有谷歌会议链接的日历活动”* - *“显示我本月的所有定期会议”* - *“查找下周与外部与会者安排的所有会议”*
安装
选项1：通过Smithery快速安装（推荐）📦
开始使用MCP GSuite Enhanced的最快方法：
npx -y @smithery/cli install mcp-gsuite-enhanced --client claude这将自动：
- ✅ 下载并安装最新版本
- ✅ 为您配置克劳德桌面
- ✅ 设置MCP服务器条目
选项2：手动安装🔧
对于高级用户或开发目的：
光标IDE设置
对于Cursor IDE用户，请使用安装助手脚本：
python cursor_setup.py这将生成正确的MCP配置，并提供将其添加到光标设置的分步说明。
紫外线手动安装（推荐）
git clone https://github.com/ajramos/mcp-gsuite-enhanced
cd mcp-gsuite-enhanced
uv sync使用pip手动安装
git clone https://github.com/ajramos/mcp-gsuite-enhanced
cd mcp-gsuite-enhanced
pip install -e .设置Google身份验证
谷歌云配置
您需要创建一个Google Cloud项目并配置OAuth2凭据：
第一步：创建谷歌云项目
- 转到 谷歌云控制台
- 创建新项目或选择现有项目
- 启用所需的API：
- 转到“API和服务”→ “图书馆” - 搜索 “Gmail API” 并启用它 - 搜索 “Google日历API” 并启用它
步骤2：设置OAuth 2.0凭据
- 转到“API和服务”→ “凭据”
- 点击“创建凭据”→ “OAuth客户端ID”
- 选择 “桌面应用程序” 作为应用程序类型
- 如果系统提示，配置OAuth同意屏幕
- 下载凭据JSON文件并将其另存为
.gauth.json在您的项目目录中
步骤3：配置您的Google帐户
创建一个 .accounts.json 项目目录中的文件，以指定要使用的Google帐户：
{
"accounts": [
{
"email": "your-work@company.com",
"account_type": "work",
"extra_info": "Work account with company calendar"
},
{
"email": "your-personal@gmail.com",
"account_type": "personal",
"extra_info": "Personal account with family calendar"
}
]
}字段说明：
email：您的Google帐户电子邮件地址account_type：“工作”、“个人”等类别。（帮助组织）extra_info：有助于AI理解此帐户目的的其他上下文
步骤4：验证您的Google帐户
一旦你两者都有 .gauth.json 和 .accounts.json 文件，为每个帐户运行身份验证设置：
python auth_setup.py your-work@company.com
python auth_setup.py your-personal@gmail.com此脚本将自动处理OAuth流，并将您的凭据安全地存储在 .oauth2.{email}.json 文件夹。
⚠️ 安全警告：从不提交凭据文件(.gauth.json,.accounts.json,.oauth2.*.json)版本控制！将它们添加到您的.gitignore文件，以防止意外暴露敏感的身份验证数据。
OAuth 2.0作用域（自动）
服务器自动请求这些权限- 无需手动配置:
[
"openid",
"https://www.googleapis.com/auth/userinfo.email",
"https://mail.google.com/",
"https://www.googleapis.com/auth/calendar"
]这些作用域允许服务器：
- ✅ 访问您的Gmail（阅读、发送、管理草稿）
- ✅ 管理您的Google日历（创建、更新、删除事件）
- ✅ 自动创建Google Meet链接
- ✅ 识别您的Google帐户
配置示例
克劳德桌面（增强版）
将此添加到您的Claude Desktop配置中：
{
"mcpServers": {
"mcp-gsuite-enhanced": {
"command": "uv",
"args": [
"--directory",
"/path/to/mcp-gsuite-enhanced",
"run",
"mcp-gsuite-enhanced"
]
}
}
}克劳德桌面（Smithery安装）
如果您是通过Smithery安装的，您的配置将自动处理！无需手动设置。
与uvx（增强版）一起使用
{
"mcpServers": {
"mcp-gsuite-enhanced": {
"command": "uv",
"args": [
"--directory",
"/path/to/mcp-gsuite-enhanced",
"run",
"mcp-gsuite-enhanced"
]
}
}
}增强的Google Meet集成
增强版会自动为新的日历事件创建Google Meet链接：
{
"calendar_id": "primary",
"summary": "Team Standup",
"start_time": "2024-01-15T10:00:00Z",
"end_time": "2024-01-15T10:30:00Z",
"attendees": "team@company.com,lead@company.com",
"create_meet_link": true
}日历事件的结果如下：
- ✅ 自动谷歌会议链接
- ✅ 电话拨入号码
- ✅ 会议PIN
- ✅ 所有与会者均受邀
发展
为发展而设立：
git clone https://github.com/ajramos/mcp-gsuite-enhanced
cd mcp-gsuite-enhanced
uv sync
uv run mcp-gsuite-enhanced使用MCP检查器进行调试
由于MCP服务器在stdio上运行，调试可能具有挑战性。为了获得最佳的调试体验，我们强烈建议使用 MCP检查员.
您可以通过以下方式启动MCP检查器 使用此命令：
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite-enhanced run mcp-gsuite-enhanced启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。
服务器日志
您还可以使用以下命令查看服务器日志：
# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite-enhanced.log
# Linux
tail -n 20 -f ~/.config/Claude/logs/mcp-server-mcp-gsuite-enhanced.log
# Windows
Get-Content "$env:APPDATA\Claude\logs\mcp-server-mcp-gsuite-enhanced.log" -Wait -Tail 20安全
- 所有身份验证都使用OAuth 2.0在本地处理
- 凭据安全地存储在本地文件中
- 除谷歌的API外，不会向第三方发送任何数据
- 支持具有独立凭据的多个Google帐户
鸣谢
基于 mcp gsuite 马库斯·普芬德斯坦。
通过全面的Gmail API覆盖、Google Meet集成和Angel Ramos改进的功能进行了增强。
致谢
- 原始项目： mcp gsuite Markus Pfundstein（麻省理工学院许可证）
- 受社区MCP实施启发的Gmail功能，包括 Gmail MCP服务器
- 所有代码均使用官方Google API文档独立实现
- 根据麻省理工学院许可-未纳入GPL代码
许可证
MIT许可证-有关详细信息，请参阅许可证文件。
贡献
欢迎投稿！请随时提交拉取请求。
支持
如果您在使用增强功能时遇到任何问题：
- 检查日志 使用上面的调试说明
- 验证身份验证 通过跑步
python auth_setup.py - 打开一个问题 与：
- 您的操作系统 - Python版本 - 错误消息或日志 - 重现问题的步骤
有关MCP的一般问题，请参阅 模型上下文协议文档.