shield_lock
JinDaGe
Contact
← Back to MCP directory
publicPublicdnsLocal runtime

gcal-mcp-server

一个提供Google Calendar集成的MCP服务器，支持通过标准化接口管理日历事件

article

README

🚀 Google Calendar MCP 服务器

这是一个基于Model Context Protocol (MCP) 的服务器，借助标准化接口实现与Google Calendar的集成。它为LLM应用程序提供了管理日历事件的能力，方便用户进行各类日历操作。

🚀 快速开始

在使用本服务器前，你需要完成Google Cloud的相关设置，并进行服务器的安装。具体步骤如下：

✨ 主要特性

  • 列出可用日历
  • 从日历中列出事件
  • 创建新的日历事件
  • 更新现有事件
  • 删除事件

📦 安装指南

步骤

  1. 克隆仓库：
git clone <repository-url>
cd gcal-mcp-server
  1. 创建虚拟环境：
uv venv
# 在 Mac/Linux 上
source .venv/bin/activate
# 在 Windows 上
.venv\Scripts\activate
# 以编辑模式安装包
uv pip install -e .

📚 详细文档

Google Cloud 设置

  1. 访问 Google Cloud Console
  2. 创建新项目或选择现有项目。
  3. 启用 Google Calendar API。
  4. 创建OAuth 2.0凭证：
    • 转到 凭证
    • 点击 "创建凭证" > "OAuth 客户端 ID"
    • 选择 "用户数据" 作为应用程序将访问的数据类型。
    • 添加您的应用名称和联系信息。
    • 添加以下范围（可选）：
      • https://www.googleapis.com/auth/calendar.events
    • 选择 "桌面应用" 作为应用类型。
    • 在 OAuth 同意屏幕 下添加您的电子邮件地址作为测试用户。
      • 注意： 测试用户的传播可能需要几分钟。

💻 使用示例

基础用法

运行服务器

# 设置所需的 `.env` 文件环境变量。
# 运行服务器
uv run client.py
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client