GoogleCalendarMCP

一个用于与 Google 日历交互的 模型补全提示 (MCP) 插件。

特性

• 在 Google 日历中创建具有以下可定制属性的事件：
  • 开始和结束时间
  • 描述
  • 地点
  • 参与者
  • 时区

安装

1. 克隆此仓库：

git clone https://github.com/ITworkonline/GoogleCalendarMCP.git
cd GoogleCalendarMCP

2. 创建一个虚拟环境并安装依赖项：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上： .venv\Scripts\activate
pip install -e .

3. 设置 Google Calendar API：
   • 前往 Google Cloud Console
   • 创建一个新项目
   • 启用 Google Calendar API
   • 创建 OAuth 2.0 凭据（桌面应用）
   • 下载凭据 JSON 文件并将其另存为项目根目录中的 credentials.json

用法

from GoogleCalendarMCP.main import create_event

# 创建一个日历事件
result = await create_event(
    summary="与团队会议",
    start_time="2025-04-01T10:00:00",
    end_time="2025-04-01T11:00:00",
    description="讨论项目进度",
    location="3号会议室",
    attendees=["colleague@example.com"],
    timezone="America/New_York"
)

身份验证

首次运行该程序时，它将打开一个浏览器窗口，供您使用您的 Google 帐户进行身份验证。 身份验证后，将创建一个 token.json 文件来存储您的凭据，以供后续运行使用。

许可证

MIT