Google 日历集成项目

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

先决条件

• Python 3.8 或更高版本

• Google 云端平台帐户

• 已启用 Google 日历 API

• OAuth 2.0 凭据已配置

Related MCP server: Google Calendar AutoAuth MCP Server

设置说明

通过 Smithery 安装

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

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

手动安装

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

特征

• 创建、读取、更新和删除日历事件

• 设置重复事件

• 管理活动参与者

• 处理事件通知和提醒

项目结构

googlecalendarMCP/
├── auth.py              # Authentication handling
├── main.py             # Main application entry point
├── requirements.txt    # Project dependencies
├── .env               # Environment variables
├── credentials.json   # Google OAuth credentials
└── token.json        # Generated OAuth token

依赖项

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

• google-auth-oauthlib

• google-auth-httplib2

• google-api-python-客户端

• python-dotenv

部署的配置：

{
  "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 文件。