返回 MCP 目录
public公开dns本地运行

gCalendar-mcp-python

一个通过MCP服务器连接Google Calendar的工具,支持在Claude桌面应用中创建和管理日历事件

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桌面应用程序。

设置步骤

  1. 在Google Cloud控制台中创建项目并生成OAuth 2.0客户端ID
    • 打开Google Cloud Console,创建新项目。
    • 转到API和服务 > 用户认证信息,创建OAuth 2.0客户端ID。
    • 启用Calendar API。
  2. 设置环境变量
GOOGLE_CLIENT_ID="your_client_id"
GOOGLE_CLIENT_SECRET="your_client_secret"
GOOGLE_REFRESH_TOKEN="your_refresh_token"
  1. 在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许可证下发布。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端