快速入门

1. 创建 Google Cloud 项目并获取凭据

   • 访问 Google Cloud Console 创建项目。
   • 启用 Google Calendar API。
   • 创建 OAuth 2.0 凭据（桌面应用或 Web 应用类型）。
   • 下载 JSON 文件并重命名为 gcp-oauth.keys.json。

2. 运行认证

   • 全局认证：将 gcp-oauth.keys.json 放入 ~/.calendar-mcp/ 目录，然后运行：

     npx @nchufa/calendar auth
     

   • 局部认证：将文件放在当前目录后运行相同命令。

3. 配置 Claude Desktop 在配置文件中添加以下内容： { "mcpServers": { "calendar": { "command": "npx", "args": ["@nchufa/calendar"] } } }

4. 使用工具

   • 创建事件：提供标题、时间等信息。
   • 查询事件：通过事件 ID 获取详情。
   • 更新事件：修改现有事件。
   • 删除事件：指定事件 ID 删除。
   • 列出事件：按时间范围列出。
   • 搜索事件：通过关键词查找。
   • 列出日历：查看所有可用日历。

支持自然语言日期时间输入如“明天下午2点”。