使用说明

项目简介

本项目 'Google Calendar MCP Server' 是一个基于 Model Context Protocol (MCP) 实现的服务器，旨在为 Claude Desktop 等 MCP 客户端提供 Google 日历的集成能力。通过此服务器，用户可以使用自然语言指令，让 LLM 客户端（如 Claude Desktop）访问和操作 Google 日历，实现日程管理自动化。

主要功能点

Google 日历事件管理：支持获取、创建、更新和删除 Google 日历事件。
OAuth2 认证：使用安全的 OAuth2 协议连接 Google Calendar API。
MCP 标准协议：基于 MCP 协议与客户端通信，易于集成到支持 MCP 的 LLM 应用中。
简单配置：通过环境变量和 JSON 配置文件进行快速配置和部署。

安装步骤

安装 npm 包: 打开终端，运行以下命令全局安装 'google-calendar-mcp' 包：

npx @takumi0706/google-calendar-mcp

配置 Google Cloud 项目:
- 访问 Google Cloud Console 创建或选择一个项目。
- 启用 Google Calendar API。
- 配置 OAuth2 同意屏幕，设置应用名称和用户支持邮箱等信息。
- 创建 OAuth2 客户端 ID，选择 "Web 应用" 类型。
  - 设置名称，例如 "Google Calendar MCP Server Client"。
  - 添加已授权的重定向 URI 为 'http://localhost:3000/oauth2callback'。
  - 记录生成的 客户端 ID 和 客户端密钥。
设置环境变量: 在你的 Claude Desktop 配置文件 'claude_desktop_config.json' 中，或者在运行服务器的环境中设置以下环境变量：
- 'GOOGLE_CLIENT_ID': 你创建的 OAuth2 客户端 ID。
- 'GOOGLE_CLIENT_SECRET': 你创建的 OAuth2 客户端密钥。
- 'GOOGLE_REDIRECT_URI': 设置为 'http://localhost:3000/oauth2callback'。

服务器配置

在 Claude Desktop 的 'claude_desktop_config.json' 文件中，添加或修改 'mcpServers' 配置，以注册 'google-calendar' MCP 服务器。以下是一个配置示例，你需要将 'your_client_id' 和 'your_client_secret' 替换为你自己的 Google OAuth2 凭据。

{
  "globalShortcut": "Shift+Alt+Space",
  "mcpServers": {
    "google-calendar": {
      "command": "npx", // 启动命令，使用 npx 运行 npm 包
      "args": [
        "-y", // 自动确认安装
        "@takumi0706/google-calendar-mcp" // 要运行的 npm 包名称
      ],
      "env": { // 环境变量配置
        "GOOGLE_CLIENT_ID": "your_client_id", // 替换为你的 Google OAuth 客户端 ID
        "GOOGLE_CLIENT_SECRET": "your_client_secret", // 替换为你的 Google OAuth 客户端密钥
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback" // 固定重定向 URI
      }
    },
    // ... 其他 MCP 服务器配置 ...
  }
}

配置说明:

'"google-calendar"': 服务器名称，在 Claude Desktop 中引用此名称。
'"command": "npx"': 指定使用 'npx' 命令来运行服务器。
'"args": ["-y", "@takumi0706/google-calendar-mcp"]': 'npx' 的参数，'-y' 表示自动确认安装，'@takumi0706/google-calendar-mcp' 是要执行的 npm 包。
'"env": { ... }': 环境变量配置，服务器运行时会读取这些环境变量。这里配置了 Google OAuth 相关的凭据。

基本使用方法

确保已正确配置 'claude_desktop_config.json' 文件，并已设置 Google OAuth 环境变量。
启动 Claude Desktop 应用程序。
Claude Desktop 会自动启动并连接到 'google-calendar' MCP 服务器。
在 Claude Desktop 中，你可以使用自然语言指令来操作 Google 日历，例如：
- "今天下午3点到4点创建一个会议，主题是项目讨论"
- "查询下周的日程安排"
- "取消明天上午10点的会议"
Claude Desktop 将会调用 'google-calendar' MCP 服务器提供的工具来执行相应的日历操作。

注意:

首次使用时，服务器会启动一个本地 Web 服务器进行 OAuth2 授权。请按照提示访问授权链接，完成 Google 账号授权。授权成功后，服务器会将 Token 保存到本地文件 'token.json' 中，后续使用将自动使用已保存的 Token。
服务器日志文件保存在用户 home 目录下的 '~/.google-calendar-mcp/logs/' 目录中，可以用于问题排查。

关键词