日历 MCP 服务器
用于在 Claude Desktop 中集成 Google 日历的模型上下文协议 (MCP) 服务器。该服务器使 AI 助手能够通过自然语言交互来管理 Google 日历事件。
特征
- 创建带有标题、时间、描述和位置的日历事件
- 通过事件 ID 检索事件详细信息
- 更新现有事件（标题、时间、描述、地点）
- 删除事件
- 列出指定时间范围内的事件
- 与 Google 日历 API 完全集成
- 安全 OAuth2 身份验证
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 Google 日历集成：
npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude
手动安装
npm install @gongrzhe/server-calendar-mcp
设置
- 创建 Google Cloud 项目并获取凭据：a.创建 Google Cloud 项目：
b.创建 OAuth 2.0 凭证：
- 前往“API 和服务”>“凭证”
- 点击“创建凭证”>“OAuth 客户端 ID”
- 选择“桌面应用”作为应用程序类型
- 命名并点击“创建”
- 您将获得您的
GOOGLE_CLIENT_ID和GOOGLE_CLIENT_SECRET
c.获取刷新令牌：
- 在 Claude Desktop 中配置：
{
"calendar": {
"command": "npx",
"args": [
"@gongrzhe/server-calendar-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "your_client_id_here",
"GOOGLE_CLIENT_SECRET": "your_client_secret_here",
"GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
}
}
}
使用示例
该服务器提供了几个可以通过 Claude Desktop 使用的工具：
创建活动
{
"summary": "Team Meeting",
"start": {
"dateTime": "2024-01-20T10:00:00Z"
},
"end": {
"dateTime": "2024-01-20T11:00:00Z"
},
"description": "Weekly team sync",
"location": "Conference Room A"
}
列出事件
{
"timeMin": "2024-01-01T00:00:00Z",
"timeMax": "2024-12-31T23:59:59Z",
"maxResults": 10,
"orderBy": "startTime"
}
更新事件
{
"eventId": "event123",
"summary": "Updated Meeting Title",
"start": {
"dateTime": "2024-01-20T11:00:00Z"
},
"end": {
"dateTime": "2024-01-20T12:00:00Z"
}
}
删除事件
{
"eventId": "event123"
}
安全说明
- 确保您的 Google API 凭据安全
- 定期轮换刷新令牌
- 在 Claude Desktop 配置中存储敏感信息
- 切勿共享或提交您的凭据以进行版本控制
- 刷新令牌可让您访问 Google 日历，请将其视为密码
贡献
欢迎贡献代码！欢迎提交 Pull 请求。
执照
该项目已获得 ISC 许可。
作者
共济者
支持
如果您遇到任何问题或有疑问，请在 GitHub 存储库上提交问题。