关键词

日历管理Google日历事件管理日程安排效率工具

使用说明

项目简介

Google Calendar MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为LLM客户端（如Claude Desktop）提供访问和管理Google日历的功能。通过此服务器，LLM可以利用预设的工具，例如创建、查询和列出日历事件，从而实现智能化的日程管理和信息获取。

主要功能点

  • 日历事件管理: 提供通过 MCP URI 访问日历事件的能力，虽然代码中未直接体现资源管理，但设计上支持将日历事件作为资源进行操作。
  • 工具 (Tools):
    • 'create_event': 创建新的Google日历事件。
    • 'list_events': 列出即将到来的Google日历事件。
    • 'search_events': 根据关键词搜索日历事件。
    • 'set_calendar_defaults': 设置默认的Google账号和日历，简化后续操作。
    • 'list_calendar_accounts': 列出已配置的Google账号。
    • 'list_calendars': 列出指定Google账号下的所有日历。
  • Prompt 模板 (Prompts): 虽然README中提及 Prompt 功能，但代码实现中未找到明确的 Prompt 定义和处理逻辑，主要侧重于工具的实现。

安装步骤

  1. 安装 Node.js: 确保你的计算机上已安装 Node.js (v14 或更高版本) 和 npm (Node.js 包管理器)。
  2. 克隆仓库: 将 GitHub 仓库克隆到本地： 
    git clone https://github.com/thisnick/google-calendar-mcp.git
cd google-calendar-mcp
  3. 安装依赖: 在项目目录下运行以下命令安装项目依赖： 
    npm install
  4. 构建项目: 运行以下命令构建服务器代码： 
    npm run build
  5. 配置 Google Cloud 凭据:
    • 前往 Google Cloud Console。
    • 创建或选择一个已有的 Google Cloud 项目。
    • 启用 Google Calendar API。
    • 创建 OAuth 2.0 凭据 (应用类型选择“桌面应用”)。
    • 下载客户端密钥 JSON 文件，并将其重命名为 '.client_secret.json' 放置在项目根目录下。
  6. 首次身份验证:
    • 运行以下命令并替换 '<account-id>' 为你的账号标识符（例如 'user1'）： 
      node build/index.js auth <account-id>
    • 按照命令行提示访问提供的 URL，完成 Google 账号授权。
    • 复制授权码并粘贴回命令行终端完成认证。
    • 如果需要使用多个Google账号，重复此步骤，为每个账号设置不同的 '<account-id>'。

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）连接，你需要在客户端的配置文件中添加服务器配置信息。配置信息通常是 JSON 格式。以下是一个示例配置，你需要根据实际情况修改 'command' 字段中的路径。

{
  "mcpServers": {
    "Google Calendar": {
      "command": "/path/to/your/google-calendar-mcp/build/index.js",  //  请替换为你的 Google Calendar MCP Server 项目 build 目录下 index.js 文件的绝对路径
      "args": [] //  启动参数，本服务器实现不需要额外的启动参数，保持为空数组即可
    }
  }
}

注意:

  • 请将 '/path/to/your/google-calendar-mcp/build/index.js' 替换为你本地 Google Calendar MCP Server 项目 'build' 目录下 'index.js' 文件的绝对路径。
  • 'args' 字段用于传递启动参数，此服务器实现不需要额外的启动参数，因此配置为空数组 '[]' 即可。

Claude Desktop 客户端配置:

  • MacOS: 打开 '~/Library/Application Support/Claude/claude_desktop_config.json' 文件。
  • Windows: 打开 '%APPDATA%/Claude/claude_desktop_config.json' 文件。
  • 将上述 JSON 配置添加到 'claude_desktop_config.json' 文件中的 'mcpServers' 字段下。如果 'mcpServers' 字段不存在，请创建它。

基本使用方法

  1. 启动服务器: 当 MCP 客户端 (如 Claude Desktop) 启动并加载配置后，Google Calendar MCP Server 会自动运行。

  2. 在 MCP 客户端中使用工具: 在 MCP 客户端中，你可以通过自然语言指令或特定的操作触发配置的工具，例如：

    • 让 Claude 创建日历事件： “使用 Google Calendar 创建一个明天上午 10 点的会议，主题是项目讨论。”
    • 查询日程： “我的 Google Calendar 上下周有什么会议？”
    • 列出账号： “列出我配置的所有日历账号。”
    • 设置默认日历: “将账号 'user1' 的日历 '工作日历' 设置为默认日历。”

    具体的工具调用方式和参数需要参考 MCP 客户端的使用说明和工具的定义。

调试: 如果遇到问题，可以使用 'npm run inspector' 命令启动 MCP Inspector 进行调试，详情请参考 README 文档。

信息

分类

生产力应用

访问项目