Google Calendar AutoAuth MCP Server

基本能力

产品定位

Google Calendar AutoAuth MCP Server 是一个用于Google Calendar集成的MCP服务器，支持自动认证功能，使AI助手能够通过自然语言交互管理Google Calendar。

核心功能

• 创建日历事件（包括标题、描述、地点和参与者）
• 更新现有日历事件
• 删除日历事件
• 检索事件详情
• 列出指定时间范围内的事件
• 按关键词搜索事件
• 列出所有可用日历
• 支持自然语言日期/时间输入
• 完全集成Google Calendar API
• 简单的OAuth2认证流程，支持自动浏览器启动
• 支持桌面和Web应用凭证
• 全局凭证存储

适用场景

• 通过AI助手管理个人或团队的Google Calendar
• 自动化日程安排
• 自然语言交互的日历管理

工具列表

1. Create Event (create_event): 创建新日历事件
2. Get Event (get_event): 检索特定日历事件的详情
3. Update Event (update_event): 更新现有日历事件
4. Delete Event (delete_event): 删除日历事件
5. List Events (list_events): 列出指定时间范围内的日历事件
6. Search Events (search_events): 搜索匹配查询的事件
7. List Calendars (list_calendars): 列出所有可用日历

常见问题解答

1. OAuth Keys Not Found: 确保gcp-oauth.keys.json在当前目录或~/.calendar-mcp/中
2. Invalid Credentials Format: 确保OAuth密钥文件包含web或installed凭证
3. Port Already in Use: 如果端口3000已被占用，请释放它

使用教程

使用依赖

1. 创建Google Cloud Project并获取凭证
2. 启用Google Calendar API
3. 创建OAuth 2.0凭证

安装教程

1. 全局认证（推荐）:

mkdir -p ~/.calendar-mcp
mv gcp-oauth.keys.json ~/.calendar-mcp/
npx @nchufa/calendar auth

1. 本地认证:

npx @nchufa/calendar auth

1. 在Claude Desktop中配置:

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": [
        "@nchufa/calendar"
      ]
    }
  }
}

调试方式

1. 确保凭证文件位置正确
2. 检查文件权限
3. 确保端口3000可用

许可证

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