Google Workspace MCP Server

基本能力

产品定位

Google Workspace MCP Server 是一个用于自动化管理 Gmail 邮件和 Google Calendar 日程的工具，适用于开发者和需要批量处理邮件和日程的用户。

核心功能

1. Gmail 工具
2. list_emails: 列出收件箱中的邮件，支持过滤
3. search_emails: 使用 Gmail 查询语法进行高级邮件搜索
4. send_email: 发送新邮件，支持 CC 和 BCC

5. modify_email: 修改邮件标签（归档、删除、标记已读/未读）

6. Calendar 工具

7. list_events: 列出即将到来的日历事件，支持日期范围过滤
8. create_event: 创建新的日历事件，支持添加参与者
9. update_event: 更新现有的日历事件

10. delete_event: 删除日历事件

11. 用户工具

12. list_contacts: 列出 Google 联系人
13. get_user_info: 获取用户信息

适用场景

• 自动化处理邮件（如批量归档、标记已读）
• 批量管理日历事件（如创建、更新或删除会议）
• 集成到其他应用中，实现邮件和日程的自动化管理

工具列表

• Gmail 工具：邮件列表、搜索、发送和修改
• Calendar 工具：事件列表、创建、更新和删除
• 用户工具：联系人列表和用户信息获取

常见问题解答

• 需要有效的 Google API 访问令牌（accessToken）才能使用所有功能。
• 令牌必须具有适当的 OAuth 范围以执行操作。

使用教程

使用依赖

1. Node.js: 安装 Node.js 14 或更高版本 bash # 示例安装命令（根据系统不同可能有所变化） curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - sudo apt-get install -y nodejs

2. Google API 访问令牌: 需要有效的访问令牌以验证 Google API

安装教程

1. 克隆并安装 bash git clone https://github.com/yourusername/google-workspace-mcp-server.git cd google-workspace-mcp-server npm install

2. 构建并运行 bash npm run build

调试方式

1. 运行服务 bash npm start

2. 测试功能

3. 使用提供的 JSON 示例测试 Gmail 和 Calendar 操作
4. 确保 accessToken 参数有效且具有所需权限

项目结构

• src/index.ts: 主入口点
• src/server.ts: 服务器类，设置请求处理程序
• src/tools/definitions.ts: MCP 接口的工具定义
• src/handlers/email.ts: Gmail 操作的处理程序
• src/handlers/calendar.ts: Calendar 操作的处理程序
• src/handlers/user.ts: 用户和联系人操作的处理程序

许可证

MIT 许可证

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。