使用说明
gcal mcp
用于谷歌日历的MCP服务器。提供四种工具：列出日历、列出/搜索事件、创建事件和修改事件。
先决条件
- 紫外线
- 启用日历API的谷歌云项目
谷歌云设置
- 首选 Google 云控制台
- 创建项目（或选择现有项目）
- 启用 谷歌日历API
- 首选 API和服务>凭据
- 创建一个 OAuth 2.0客户端ID 类型 桌面应用程序
- 下载JSON凭据并将其保存到
~/.config/gcal-mcp/credentials.json - 首选 OAuth 授权界面 并将您的Google帐户添加为测试用户
安装并验证
make install # install dependencies
make auth # opens browser for OAuth consent, prints calendars on success
使用克劳德代码注册
make register # adds gcal-mcp as a user-scoped MCP server
make unregister # removes it
工具
| 工具 | 说明 |
|---|---|
list_calendars |
列出所有可访问的日历 |
list_events |
列出或搜索事件（支持时间范围、自由文本查询） |
create_event |
创建活动（支持与会者、地点、描述） |
modify_event |
修补现有事件（仅更新提供的字段） |
接受日期/时间值 YYYY-MM-DD 适用于全天活动或ISO日期时间(YYYY-MM-DDTHH:MM)对于定时事件。
文件位置
- 资格证书：
~/.config/gcal-mcp/credentials.json - OAuth令牌：
~/.config/gcal-mcp/token.json