Google Calendar MCP

Google 日历集成项目

该项目提供与 Google 日历 API 的集成，以编程方式管理和与日历事件交互。

先决条件

• Python 3.8 或更高版本
• Google 云端平台帐户
• 已启用 Google 日历 API
• OAuth 2.0 凭据已配置

设置说明

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Google 日历集成项目：

手动安装

1. 克隆存储库
   git clone https://github.com/Avik-creator/googlecalendarMCP cd googlecalendarMCP
2. 设置虚拟环境
   python -m venv venv source venv/bin/activate # On Windows, use `venv\Scripts\activate`
3. 安装依赖项
   pip install -r requirements.txt
4. Google 云平台设置a. 转到Google Cloud Console b. 创建新项目或选择现有项目 c. 启用 Google 日历 API d. 创建 OAuth 2.0 凭据：
   • 前往 API 和服务 > 凭证
   • 点击“创建凭证”>“OAuth 客户端 ID”
   • 选择“桌面应用程序”
   • 下载凭证 JSON 文件
   • 将其重命名为credentials.json并将其放在项目根目录中
5. 环境变量在项目根目录中创建一个.env文件，其中包含以下变量：
   GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json CALENDAR_ID=your_calendar_id@group.calendar.google.com

用法

1. 首次身份验证
   python auth.py
   这将打开一个用于 OAuth 身份验证的浏览器窗口。按照提示授权应用程序。
2. 运行应用程序
   python main.py

特征

• 创建、读取、更新和删除日历事件
• 设置重复事件
• 管理活动参与者
• 处理事件通知和提醒

项目结构

依赖项

该项目使用以下主要依赖项：

• google-auth-oauthlib
• google-auth-httplib2
• google-api-python-客户端
• python-dotenv

部署的配置：

安全说明

• 切勿将您的credentials.json 、 token.json或.env文件提交到版本控制
• 确保您的 OAuth 凭证安全
• 定期轮换您的凭证和令牌

贡献

1. 分叉存储库
2. 创建功能分支
3. 提交你的更改
4. 推送到分支
5. 创建拉取请求

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。