GoogleCalendarMCP

GoogleCalendarMCP

site icon
2025.03.24 0
PythonGoogle Calendar日程管理日程管理
GoogleCalendarMCP是一个用于与Google Calendar交互的Model Completion Prompt (MCP)插件。它允许用户通过简单的API调用来创建和管理Google日历中的事件,包括设置事件的开始和结束时间、描述、地点、参与者和时区等。
View on GitHub

Overview

基本能力

产品定位

GoogleCalendarMCP是一个专门用于与Google Calendar交互的工具,旨在简化日历事件的管理和创建过程。

核心功能

  • 创建Google日历事件
  • 可自定义事件的开始和结束时间
  • 可设置事件描述
  • 可指定事件地点
  • 可添加参与者
  • 可设置时区

适用场景

  • 团队会议安排
  • 个人日程管理
  • 项目进度跟踪
  • 自动化日程安排

工具列表

  • create_event:用于创建Google日历事件的函数,支持多种参数设置。

常见问题解答

  1. 如何获取Google Calendar API的凭据?
  2. 需要在Google Cloud Console中创建项目,启用Google Calendar API,并创建OAuth 2.0凭据。
  3. 如何存储认证信息?
  4. 首次运行时,系统会通过浏览器进行认证,并生成token.json文件存储凭据。

使用教程

使用依赖

  1. 确保已安装Python 3.x
  2. 确保已安装Git

安装教程

  1. 克隆仓库:
git clone https://github.com/ITworkonline/GoogleCalendarMCP.git
cd GoogleCalendarMCP
  1. 创建虚拟环境并安装依赖:
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e .
  1. 设置Google Calendar API:
  2. 访问Google Cloud Console
  3. 创建新项目
  4. 启用Google Calendar API
  5. 创建OAuth 2.0凭据(桌面应用)
  6. 下载凭据JSON文件并保存为credentials.json

调试方式

  1. 运行示例代码:
from GoogleCalendarMCP.main import create_event

result = await create_event(
    summary="Meeting with Team",
    start_time="2025-04-01T10:00:00",
    end_time="2025-04-01T11:00:00",
    description="Discuss project progress",
    location="Conference Room 3",
    attendees=["[email protected]"],
    timezone="America/New_York"
)
  1. 检查输出结果和可能的错误信息。

许可证

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