Cal.com 日历 MCP 服务器

一个与 Cal.com 日历 API 集成的 MCP 服务器实现，提供预约安排功能。

功能

• 添加预约: 安排新的日历预约，包含与会者详细信息
• 更新预约: 修改现有预约的详细信息，例如时间和备注
• 删除预约: 取消并移除现有预约
• 列出预约: 查看特定日期范围内的已安排预约

工具

• calcom_add_appointment

  • 创建新的日历预约
  • 输入:
    • eventTypeId (数字): Cal.com 事件类型 ID
    • startTime (字符串): 开始时间，ISO 格式 (YYYY-MM-DDTHH:mm:ss.sssZ)
    • endTime (字符串): 结束时间，ISO 格式 (YYYY-MM-DDTHH:mm:ss.sssZ)
    • name (字符串): 与会者姓名
    • email (字符串): 与会者邮箱
    • notes (字符串, 可选): 预约的附加备注

• calcom_update_appointment

  • 更新现有日历预约
  • 输入:
    • bookingId (数字): 要更新的 Cal.com 预订 ID
    • startTime (字符串, 可选): 新的开始时间，ISO 格式
    • endTime (字符串, 可选): 新的结束时间，ISO 格式
    • notes (字符串, 可选): 预约的新备注

• calcom_delete_appointment

  • 删除现有日历预约
  • 输入:
    • bookingId (数字): 要删除的 Cal.com 预订 ID
    • reason (字符串, 可选): 取消原因

• calcom_list_appointments

  • 列出日期范围内的日历预约
  • 输入:
    • startDate (字符串): 开始日期，YYYY-MM-DD 格式
    • endDate (字符串): 结束日期，YYYY-MM-DD 格式

配置

获取 API 密钥

1. 注册一个 Cal.com 帐户
2. 导航到 设置 > 开发者 > API 密钥
3. 生成一个新的 API 密钥，并赋予适当的权限

与 Claude Desktop 一起使用

将此添加到您的 claude_desktop_config.json：

Docker

{
  "mcpServers": {
    "calcom-calendar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CALCOM_API_KEY",
        "mcp/calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "calcom-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

构建

Docker 构建:

docker build -t mcp/calcom-calendar:latest -f Dockerfile .

许可证

此 MCP 服务器基于 MIT 许可证授权。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。