Gcal Gmail MCP

gcal gmail mcp

一个模型上下文协议（MCP）服务器，为克劳德等人工智能助理提供Gmail、谷歌日历、谷歌文档、谷歌会议、谷歌任务、谷歌表格和Trello访问权限。

特性

Gmail

• 发送和起草电子邮件（带附件、HTML、CC/BCC）
• 阅读和搜索电子邮件
• 管理标签（创建、更新、删除）
• 创建电子邮件过滤器（带模板）
• 批量操作修改/删除多封电子邮件
• 下载附件

谷歌日历

• 列出、创建、更新和删除事件
• 从自然语言快速添加事件
• 回应活动邀请（接受/拒绝/暂定）
• 列出日历并检查忙/闲状态
• 支持定期活动、与会者和Google Meet链接

谷歌文件

• 获取和添加会议笔记和议程项目
• 创建电子邮件审阅文档

谷歌见面会

• 列出会议记录
• 获取成绩单和成绩单条目

工作表

• 任务列表和任务的完整CRUD
• 移动、重新排序和清除已完成的任务

谷歌表格

• 读取和写入单元格值
• 添加行，创建电子表格和表格

特雷洛

• 板、列表、卡片、标签、检查表
• 自定义字段、注释、成员分配

快速安装

curl -fsSL https://raw.githubusercontent.com/hansd/gcal-gmail-mcp/main/install.sh | bash

这将：

1. 下载最新的JAR文件至 ~/.gcal-gmail-mcp/
2. 检查Java 21+
3. 运行身份验证（如果OAuth凭据已就绪）
4. 自动配置Claude代码

跑步前，得到 gcp-oauth.keys.json 从管理员处创建文件并将其放置在：

~/.gcal-gmail-mcp/gcp-oauth.keys.json

更新中

再次运行相同的安装命令以获取最新版本。

手动设置

Click to expand manual installation steps

先决条件

• Java 21或更高版本(下载)
• OAuth凭据文件(gcp-oauth.keys.json)来自您的管理员

一步一步

1. 下载JAR文件：

   mkdir -p ~/.gcal-gmail-mcp
   curl -L -o ~/.gcal-gmail-mcp/gcal-gmail-mcp.jar \
     $(curl -s https://api.github.com/repos/hansd/gcal-gmail-mcp/releases/latest \
       | grep browser_download_url | cut -d '"' -f 4)

1. 放置OAuth凭据：

   cp /path/to/gcp-oauth.keys.json ~/.gcal-gmail-mcp/gcp-oauth.keys.json

1. 身份验证：

   java -jar ~/.gcal-gmail-mcp/gcal-gmail-mcp.jar auth

1. 配置克劳德代码：

   claude mcp add gmail-kotlin --scope user -- java -jar ~/.gcal-gmail-mcp/gcal-gmail-mcp.jar

从源头构建

Click to expand (for developers only)

git clone https://github.com/hansd/gcal-gmail-mcp.git
cd gcal-gmail-mcp
./gradlew install

环境变量

• GOOGLE_OAUTH_PATH -OAuth客户端凭据JSON路径（默认值： ~/.gcal-gmail-mcp/gcp-oauth.keys.json)
• GMAIL_CREDENTIALS_PATH -存储用户凭据的路径（默认值： ~/.gcal-gmail-mcp/credentials.json)

可用工具

Gmail（19个工具）

日历（11个工具）

文档（5个工具）

满足（3个工具）

任务（10个工具）

表格（7个工具）

Trello（25工具）

OAuth范围

• gmail.modify -阅读、发送和管理电子邮件
• gmail.settings.basic -管理过滤器和标签
• calendar -完全日历访问
• documents -创建和编辑谷歌文档
• meetings.space.readonly -阅读会议记录和成绩单
• tasks -完整的谷歌任务访问权限
• spreadsheets -读写谷歌表格

备注

• 这 From 标头会自动设置为经过身份验证的Gmail地址
• UI启动的进程（如MCP客户端）可能不会继承shell环境变量-set GOOGLE_OAUTH_PATH 如果需要，在MCP服务器配置中明确显示
• Trello集成需要一个单独的API密钥和令牌（通过 TRELLO_API_KEY 和 TRELLO_TOKEN 环境变量）

许可证

麻省理工学院