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：

{
  "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 License授权。这意味着您可以自由地使用、修改和分发软件，但需遵守MIT License的条款和条件。有关详细信息，请参阅项目仓库中的LICENSE文件。