Google Calendar MCP Server

基本能力

产品定位

Google Calendar MCP Server 是一个集成Google Calendar功能的中间件服务，旨在通过Claude提供便捷的日历管理能力。

核心功能

1. 列出指定时间范围内的日历事件
2. 创建新的日历事件
3. 更新现有日历事件
4. 删除日历事件
5. 查找日历中的空闲时间段

适用场景

1. 个人日程管理
2. 团队会议安排
3. 时间规划与优化
4. 自动化日程管理

工具列表

1. list_events: 列出指定时间范围内的日历事件
2. create_event: 创建新的日历事件
3. update_event: 更新现有日历事件
4. delete_event: 删除日历事件
5. find_free_time: 查找日历中的空闲时间段

常见问题解答

1. 工具未出现在Claude中
2. 检查Claude Desktop日志
3. 验证环境变量设置是否正确

4. 确保index.js路径正确且为绝对路径

5. 认证错误

6. 验证OAuth凭据是否正确
7. 检查刷新令牌是否有效

8. 确保所需范围已启用

9. 服务器连接问题

10. 检查服务器是否构建成功
11. 验证build/index.js的文件权限(应为755)
12. 尝试直接运行服务器

使用教程

使用依赖

1. Node.js (v16或更高版本)
2. Claude Desktop App
3. Google Cloud项目
4. 启用的Google Calendar API
5. OAuth 2.0凭据

安装教程

1. 创建Google Cloud项目并启用Calendar API
2. 配置OAuth同意屏幕
3. 创建OAuth 2.0凭据
4. 获取刷新令牌
5. 配置Claude Desktop

具体命令:

# 安装依赖
npm install googleapis

# 获取刷新令牌
node getToken.js

# 项目初始化
mkdir google-calendar-mcp
cd google-calendar-mcp
npm init -y

# 安装依赖
npm install @modelcontextprotocol/sdk googleapis google-auth-library zod
npm install -D @types/node typescript

# 构建服务器
npm run build

调试方式

1. 查看日志:

# MacOS/Linux
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

# Windows
Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20

1. 直接运行服务器:

node /path/to/build/index.js

许可证

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