MCP Calendar

MCP Calendar

site icon
2025.04.08 1
PythonGoogle Calendar 事件管理日程管理工具日程管理
gCalendar-mcp-python 是一个基于 MCP(Model Context Protocol) 服务器的工具,用于通过 Claude 桌面应用创建和管理 Google Calendar 事件。它提供了安全的 OAuth2 认证和事件管理功能。
View on GitHub

Overview

基本能力

产品定位

gCalendar-mcp-python 是一个用于管理 Google Calendar 事件的工具,通过与 Claude 桌面应用集成,提供便捷的事件创建和管理功能。

核心功能

  • 通过 Claude 桌面应用和 MCP 服务器创建 Google Calendar 事件
  • 支持 OAuth2 认证,确保与 Google Calendar API 的安全交互
  • 提供事件创建、修改和查看功能

适用场景

  • 个人日程管理
  • 团队会议安排
  • 自动化日程添加

工具列表

  • mcp-calendar-python: 主工具,用于与 Google Calendar API 交互并管理事件

常见问题解答

  • 需要确保 Python 3.10 或更高版本已安装
  • 需要有效的 Google Cloud OAuth 2.0 客户端 ID 和密钥
  • 需要配置正确的环境变量

使用教程

使用依赖

  • Python 3.10 或更高版本
  • Google Cloud Console 中创建的 OAuth 2.0 客户端 ID 和密钥
  • Claude 桌面应用

安装教程

pip install mcp-calendar-python

调试方式

  1. 确保环境变量已正确设置:
GOOGLE_CLIENT_ID="your_client_id"
GOOGLE_CLIENT_SECRET="your_client_secret"
GOOGLE_REFRESH_TOKEN="your_refresh_token"
  1. 在 Claude 桌面应用中配置工具:
{
  "mcp-calendar-python": {
    "command": "uvx",
    "args": [
      "mcp-calendar-python"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "your_client_id", 
      "GOOGLE_CLIENT_SECRET": "your_client_secret", 
      "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
    }
  }
}
  1. 通过 Claude 桌面应用发送指令,例如:
  2. "내일 오후 2시에 팀 미팅 일정을 추가해줘"
  3. "5월 15일 점심시간에 미팅 일정을 추가해줘"

许可证

该项目遵循 MIT 开源许可条款。