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

gCalendar-mcp

一个实现MCP协议的Google日历服务,支持AI助手管理日历事件

article

README

🚀 MCP 谷歌日历服务器

本项目是一个实现了模型上下文协议(MCP)的服务器,借助它,像Claude这样的AI助手能够轻松创建和管理谷歌日历活动,为日程管理带来极大便利。

🚀 快速开始

先决条件

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

设置

将以下内容粘贴到Claude的claude_desktop_config.json文件中:

{
   "mcpServers": {
     "zmes-calendar": {
       "command": "npx",
       "args": [
         "-y",
         "@tobedoit/google-calendar-mcp"
       ],
       "env": {
         "GOOGLE_CLIENT_ID": "你的谷歌客户端ID",
         "GOOGLE_CLIENT_SECRET": "你的谷歌客户端秘密",
         "GOOGLE_REFRESH_TOKEN": "你的谷歌刷新令牌"
       }
     }
   }
 }

✨ 主要特性

  • 事件创建:可创建带有标题、描述、开始/结束时间和提醒的事件。
  • 与会者添加:支持为事件添加与会者。
  • 身份验证:采用Google Calendar API的OAuth2身份验证,保障数据安全。
  • 协议实现:完整实现MCP协议。
  • 调试日志:提供调试日志记录,方便进行故障排除。
help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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