Google Calendar MCP Server

Google Calendar MCP Server

site icon
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 方法)

安装教程

  1. 克隆仓库
git clone https://github.com/Jackson88/google-calendar-mcp
cd google-calendar-mcp
  1. 安装依赖
npm install
# 或
yarn install
  1. 配置环境变量
cp .env.example .env

然后编辑 .env 文件

调试方式

  1. 开发模式
npm run dev
# 或
yarn dev
  1. 生产模式
npm run build
npm run start
# 或
yarn build
yarn start
  1. 测试
npm test
# 或
yarn test

许可证

该项目遵循 Other 开源许可条款,请参阅 Other 了解完整条款。