GoogleCalendarMCP

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

功能

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

安装

1. 克隆此仓库：
   bash
   git clone https://github.com/ITworkonline/GoogleCalendarMCP.git
   cd GoogleCalendarMCP

2. 创建虚拟环境并安装依赖项：
   bash
   python -m venv .venv
   source .venv/bin/activate # 在Windows上: .venvScriptsactivate
   pip install -e .

3. 设置Google日历API：

   • 前往Google Cloud Console
   • 创建新项目
   • 启用Google日历API
   • 创建OAuth 2.0凭据（桌面应用）
   • 下载凭据JSON文件，并将其保存为credentials.json在项目根目录下

使用方法

python
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