Google Calendar MCP Server

基本能力

产品定位

Google Calendar MCP Server 是一个用于管理 Google 日历事件的 MCP 服务，旨在通过 MCP 接口简化日历事件的操作。

核心功能

• 查看日历事件：支持查看任何日期或日期范围内的事件。
• 创建新事件：可以创建包含标题、时间、描述、地点和参与者的新事件。
• 更新现有事件：支持修改现有事件的详细信息。
• 预构建提示：提供常见日历操作的预构建提示。

适用场景

• 个人日程管理
• 团队会议安排
• 自动化日历操作

工具列表

1. list_events(date_start, date_end=None) - 列出指定日期范围内的事件。
2. create_event(summary, start_datetime, end_datetime, ...) - 创建新日历事件。
3. update_event(event_id, ...) - 更新现有事件。

常见问题解答

• Python 版本问题：需要 Python 3.10 或更高版本。
• 认证错误：确保 credentials.json 文件正确放置且权限正确。
• MCP 安装问题：建议使用 uv 替代 pip 以获得更可靠的安装体验。

使用教程

使用依赖

1. Python 3.10 或更高版本 bash python --version
2. Google Cloud 项目：需启用 Calendar API 并创建 OAuth 凭据。

安装教程

1. 克隆仓库： bash git clone <repository-url> cd google-calendar-mcp
2. 创建虚拟环境： bash python3.10 -m venv venv source venv/bin/activate
3. 安装依赖： bash pip install -r requirements.txt 或使用 uv： bash curl -fsSL https://astral.sh/uv/install.sh | sh uv pip install -r requirements.txt
4. 设置 Google Calendar API 凭据：
5. 下载凭据 JSON 文件并保存为 credentials.json。

调试方式

1. 开发模式运行： bash mcp dev calendar_mcp_server.py
2. 验证 MCP 服务器是否正常运行：
3. 在 Claude Desktop 中检查 "Active MCP Servers" 列表。
4. 确保 "Google Calendar" 显示为绿色状态。

许可证

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