
Google Calendar MCP Server

2025.04.04
0
TypeScript日历管理日程自动化日程管理
Google Calendar MCP Server 是一个基于 TypeScript 的 Model Context Protocol (MCP) 服务器,允许 Claude Desktop 连接并与 Google Calendar 进行交互。该服务器提供了与 Google Calendar 的连接、授权、事件管理等功能,旨在为用户提供一个便捷的方式来通过 Claude Desktop 管理他们的日历事件。
View on GitHub
Overview
基本能力
产品定位
Google Calendar MCP Server 是一个中间件服务,旨在桥接 Claude Desktop 和 Google Calendar,使得用户可以通过 Claude Desktop 直接管理和操作他们的 Google Calendar 事件。
核心功能
- 连接 Claude Desktop AI 到 Google Calendar 数据
- 通过 Google OAuth2 进行授权
- 检索日历列表和事件
- 创建、更新和删除日历事件
- 获取所有日历的即将发生的事件
- 安全的令牌处理
- 使用 TypeScript 强类型
适用场景
- 通过 Claude Desktop 查询和管理日历事件
- 自动化日程安排
- 团队会议调度
- 个人时间管理
工具列表
- Google OAuth2 授权工具:用于安全地授权访问 Google Calendar
- 事件管理工具:用于创建、更新、删除和查询日历事件
- 日历列表工具:用于检索和管理用户的日历列表
常见问题解答
- Claude Desktop 连接问题:当前版本的 Claude Desktop 可能不支持外部 MCP 服务器连接
- 授权问题:确保正确配置了 Google OAuth2 凭据
- 日历访问问题:确保用户已授予必要的权限
使用教程
使用依赖
- Node.js (v16 或更高版本)
- npm 或 yarn
- 具有 Calendar 访问权限的 Google 账户
- Google OAuth2 凭据(用于 Cloud OAuth 方法)
安装教程
- 克隆仓库
git clone https://github.com/Jackson88/google-calendar-mcp
cd google-calendar-mcp
- 安装依赖
npm install
# 或
yarn install
- 配置环境变量
cp .env.example .env
然后编辑 .env
文件
调试方式
- 开发模式
npm run dev
# 或
yarn dev
- 生产模式
npm run build
npm run start
# 或
yarn build
yarn start
- 测试
npm test
# 或
yarn test