Calendar MCP Server

基本能力

产品定位

Calendar-MCP-Server 是一个用于 Google Calendar 集成的 MCP 服务器，旨在通过自然语言交互帮助用户管理日历事件。

核心功能

• 创建日历事件（包括标题、时间、描述和地点）
• 通过事件 ID 检索事件详情
• 更新现有事件（标题、时间、描述、地点）
• 删除事件
• 列出指定时间范围内的事件
• 完全集成 Google Calendar API
• 安全的 OAuth2 认证

适用场景

• 通过 AI 助手管理个人或团队日程
• 自动化日历事件创建和更新
• 批量管理日历事件

工具列表

1. Create Event：创建新的日历事件
2. List Events：列出指定时间范围内的事件
3. Update Event：更新现有事件
4. Delete Event：删除指定事件

常见问题解答

• 如何获取 Google API 凭证？：需要在 Google Cloud Console 创建项目并启用 Calendar API，然后创建 OAuth 2.0 凭证。
• 如何安全存储凭证？：建议将敏感信息存储在 Claude Desktop 配置中，不要提交到版本控制系统。
• 如何更新刷新令牌？：定期轮换刷新令牌以增强安全性。

使用教程

使用依赖

• 需要 Google Cloud 项目和有效的 OAuth 2.0 凭证

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude

手动安装

npm install @gongrzhe/server-calendar-mcp

调试方式

1. 确保所有环境变量（GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN）已正确设置
2. 使用示例 JSON 命令测试各个功能（创建、列出、更新、删除事件）
3. 检查 Claude Desktop 的日志以查看任何错误信息

安全注意事项

• 保持 Google API 凭证安全
• 定期轮换刷新令牌
• 不要共享或提交凭证到版本控制
• 刷新令牌具有对 Google Calendar 的访问权限，应像密码一样保护

许可证

该项目遵循 ISC 开源许可条款。