JinDaGe - gCalendar-mcp-python MCP Details

article

README

🚀 MCP日历

MCP日历是一款借助MCP（模型上下文协议）服务器，实现通过Google Calendar创建事件的实用工具。它为用户提供了便捷、安全的方式来管理Google Calendar中的事件。

🚀 快速开始

MCP日历可帮助你在Claude桌面应用程序中轻松创建Google Calendar事件。以下是使用该工具的详细步骤。

✨ 主要特性

跨应用集成：支持通过MCP服务器从Claude桌面应用程序中创建Google Calendar事件。
安全认证：采用OAuth2进行安全的Google Calendar API认证，保障数据安全。
多功能支持：支持事件的创建、修改和查看功能，满足多样化的日程管理需求。

📦 安装指南

使用以下命令安装mcp-calendar-python：

pip install mcp-calendar-python

💻 使用示例

基础用法

你可以向Claude发送以下自然语言请求来安排日程：

"明天下午2点安排团队会议"
"5月15日中午安排一次会面"

📚 详细文档

必备要求

Python 3.10或更高版本。
在Google Cloud Console中生成的OAuth 2.0客户端ID和秘密。
Claude桌面应用程序。

设置步骤

在Google Cloud控制台中创建项目并生成OAuth 2.0客户端ID：
- 打开Google Cloud Console，创建新项目。
- 转到API和服务 > 用户认证信息，创建OAuth 2.0客户端ID。
- 启用Calendar API。
设置环境变量：

GOOGLE_CLIENT_ID="your_client_id"
GOOGLE_CLIENT_SECRET="your_client_secret"
GOOGLE_REFRESH_TOKEN="your_refresh_token"

在Claude桌面应用程序中使用以下配置：

{
  "mcp-calendar-python": {
    "command": "uvx",
    "args": [
      "mcp-calendar-python"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "your_client_id", 
      "GOOGLE_CLIENT_SECRET": "your_client_secret", 
      "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
    }
  }
}

📄 许可证

此项目在MIT许可证下发布。

gCalendar-mcp-python