关键词

Google日历日程管理事件调度效率工具API集成

使用说明

项目简介

Google日历MCP服务器是一个实现了Model Context Protocol (MCP) 的后端应用，它允许大型语言模型（LLM）通过标准化的接口访问和操作用户的Google日历。通过此服务器，LLM可以读取日历信息、创建新的日程、更新现有日程以及管理日程参与者等。

主要功能点

  • 日历管理：
    • 列出和选择可用的日历
    • 查看日历事件的详细信息
    • 创建新的日历事件
    • 更新现有事件
    • 删除事件
    • 管理事件参与者和回复
  • 安全认证：
    • 使用安全的 OAuth 2.0 认证流程
    • 自动处理令牌刷新

安装步骤

  1. 克隆仓库 
    git clone https://github.com/nspady/google-calendar-mcp.git
cd google-calendar-mcp
  2. 安装依赖 
    npm install
  3. 配置Google Cloud
    • 前往 Google Cloud Console 创建或选择一个项目。
    • 启用 Google Calendar API。
    • 创建 OAuth 2.0 凭据：
      • 选择 "用户数据" 类型。
      • 添加应用名称和联系信息。
      • 添加 'https://www.googleapis.com/auth/calendar.events' 作用域（可选）。
      • 选择 "桌面应用" 作为应用类型。
      • 在 OAuth 同意屏幕 中添加您的邮箱为测试用户。
  4. 下载并配置OAuth凭据
    • 从 Google Cloud Console 下载 OAuth 凭据 JSON 文件。
    • 将下载的文件重命名为 'gcp-oauth.keys.json' 并放置在项目根目录下。

服务器配置

要将此MCP服务器配置到MCP客户端（例如Claude Desktop），您需要提供以下JSON配置信息。请根据您的实际项目路径修改 'args' 中的路径。

{
  "mcpServers": {
    "google-calendar": {
      "command": "node",
      "args": ["<absolute-path-to-project>/build/index.js"]
    }
  }
}
  • 'server name': '"google-calendar"' （MCP客户端中用于标识此服务器的名称）
  • 'command': '"node"' （启动服务器的命令，通常为Node.js）
  • 'args': '["<absolute-path-to-project>/build/index.js"]' （命令参数，指向编译后的服务器入口文件。请将 '<absolute-path-to-project>' 替换为项目在您电脑上的绝对路径）

基本使用方法

  1. 启动服务器 
    npm start
    首次启动时，如果未完成OAuth认证，服务器会自动打开浏览器进行Google账号授权。按照提示完成授权后，服务器将开始运行。
  2. 在MCP客户端中使用 将上述服务器配置添加到您的MCP客户端配置文件中。客户端将能够通过配置的服务器名称 '"google-calendar"' 连接到此Google日历MCP服务器，并调用其提供的各种日历管理工具。具体工具列表请参考仓库 'README.md' 或服务器的 'ListTools' 接口响应。

信息

分类

生产力应用

访问项目