Google 日历集成项目

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

前提条件

• Python 3.8 或更高版本
• Google Cloud Platform 账户
• 启用 Google 日历 API
• 配置 OAuth 2.0 凭证

设置说明

通过 Smithery 安装

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

bash
npx -y smithery install @Avik-creator/googlecalendarMCP --client claude

手动安装

1. 克隆仓库
   bash
   git clone https://github.com/Avik-creator/googlecalendarMCP
   cd googlecalendarMCP

2. 设置虚拟环境
   bash
   python -m venv venv
   source venv/bin/activate # 在 Windows 上使用 venvScriptsactivate

3. 安装依赖项
   bash
   pip install -r requirements.txt

4. Google Cloud Platform 设置

   a. 访问 Google Cloud 控制台
   b. 创建新项目或选择现有项目
   c. 启用 Google 日历 API
   d. 创建 OAuth 2.0 凭证：

   • 转到 APIs & Services > Credentials
   • 点击 "Create Credentials" > "OAuth client ID"
   • 选择 "Desktop Application"
   • 下载凭证 JSON 文件
   • 将其重命名为 credentials.json 并放置在项目根目录中

5. 环境变量

   在项目根目录中创建一个 .env 文件，并包含以下变量：

   GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json
   CALENDAR_ID=your_calendar_id@group.calendar.google.com

使用方法

1. 首次认证
   bash
   python auth.py

   这将打开一个浏览器窗口进行 OAuth 认证。按照提示授权应用程序。

2. 运行应用程序
   bash
   python main.py

功能

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

项目结构

googlecalendarMCP/
├── auth.py # 认证处理
├── main.py # 主应用程序入口点
├── requirements.txt # 项目依赖项
├── .env # 环境变量
├── credentials.json # Google OAuth 凭证
└── token.json # 生成的 OAuth 令牌

依赖项

该项目使用的主要依赖项包括：

• google-auth-oauthlib
• google-auth-httplib2
• google-api-python-client
• python-dotenv

部署配置

json
{
"mcpServers": {
"google_calendar_mcp": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp-google-calendar.avikm744.workers.dev/sse"
]
}
}
}

安全注意事项

• 永远不要将 credentials.json、token.json 或 .env 文件提交到版本控制系统
• 保护好您的 OAuth 凭证
• 定期轮换您的凭证和令牌

贡献

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

许可证

本项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。