🗓️ Google Calendar MCP Server
2025.04.17
0
TypeScriptGoogle日历集成AI日历管理日程管理
mcp-google-calendar 是一个基于 Typescript 和 nodejs 开发的 Model Context Protocol (MCP) 服务器，旨在让 Claude Desktop 能够连接并交互 Google 日历。该服务提供了与 Google 日历的全面集成，包括检索日历列表和事件、创建、更新和删除事件等功能，并支持自动令牌管理。
View on GitHub
Overview
基本能力
产品定位
mcp-google-calendar 是一个连接 Claude Desktop 和 Google 日历的中间件服务，旨在通过 MCP 协议实现 AI 助手与日历服务的无缝集成。
核心功能
- 连接 Claude Desktop AI 到 Google 账户
- 检索日历列表和事件
- 创建、更新和删除日历事件
- 自动令牌管理
适用场景
- 通过 AI 助手查询日历事件
- 通过 AI 助手管理个人或团队日程
- 自动化日历事件管理
工具列表
- Google OAuth2 认证系统：用于安全连接 Google 账户
- Express 服务器：提供 MCP 服务接口
- 本地令牌存储系统：自动管理认证令牌
常见问题解答
- 如何获取 Google OAuth2 凭证？
- 需要在 Google Cloud Console 创建项目并配置 OAuth 客户端
- 令牌存储在哪里？
- 令牌存储在本地文件中，不会暴露在网上
- 如何验证连接是否成功？
- 可以通过询问 Claude AI 关于日历事件的问题来验证
使用教程
使用依赖
- Node.js (v16 或更高版本)
- npm 或 yarn
- 具有日历访问权限的 Google 账户
- Google OAuth2 凭证
- Claude Desktop
安装教程
- 克隆仓库
git clone https://github.com/RossiFire/mcp-google-calendar
cd mcp-google-calendar
- 安装依赖
npm install
# 或
yarn install
- 配置环境变量
cp .env.example .env
然后编辑 .env 文件配置您的凭证 4. 构建项目
npm run build
调试方式
- 配置 Claude Desktop 连接 MCP 服务器
- 启动 Claude Desktop 并登录 Google 账户
- 测试连接
What events do I have today?
What's on my calendar for next week?