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

mcp-google-calendar

一个实现MCP协议的服务器,允许AI助手通过Google Calendar API创建和管理日历事件,支持OAuth2认证和事件管理功能。

article

README

🚀 MCP 谷歌日历服务器

MCP 谷歌日历服务器实现了模型上下文协议(MCP),能让 AI 助手(如 Claude)创建和管理谷歌日历事件,为日历管理带来了极大便利。

🚀 快速开始

MCP 谷歌日历服务器可让 AI 助手轻松与谷歌日历交互。通过以下步骤,你可以快速搭建并运行该服务器。

✨ 主要特性

  • 活动创建:可创建带有标题、描述、开始/结束时间的日历活动。
  • 参与者添加:支持为活动添加参与者。
  • 安全认证:采用 OAuth2 身份验证,与 Google Calendar API 集成,保障数据安全。
  • 协议完整:实现了完整的 MCP 协议。
  • 调试便利:提供调试日志,便于故障排除。

📦 安装指南

先决条件

  • Node.js v18 或更高版本。
  • 启用了谷歌云控制台项目的日历 API。
  • OAuth2 凭证(客户端 ID 和客户端密钥)。

安装步骤

  1. 克隆仓库
git clone [https://github.com/markelaugust74/mcp-google-calendar.git]
cd mcp-google-calendar
  1. 安装依赖项
npm install
  1. 配置环境变量
    • 复制 .env.example 文件为 .env
    • 添加您的谷歌 OAuth2 凭证。
  2. 获取刷新令牌
npm run auth
  1. 更新 index.js 中的刷新令牌

💻 使用示例

基础用法

启动服务器:

npm start
help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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