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文件。