JinDaGe - Cal.com Calendar MCP Details

article

README

🚀 Cal.com日历MCP服务器

Cal.com日历MCP服务器集成了Cal.com日历API，为用户提供便捷的预约安排功能，可轻松管理各类日历会议。

🚀 快速开始

若要使用Cal.com日历MCP服务器，你需要先获取API密钥，再根据自身需求选择合适的配置方式，最后完成服务器的构建。

✨ 主要特性

添加预约：可安排新的日历会议，并能详细记录与会者的相关信息。
更新预约：能够灵活修改现有预约的详情，例如调整时间、添加或修改备注等。
删除预约：可取消并移除不再需要的现有预约。
列出预约：支持查看特定日期范围内已安排的所有预约。

📦 安装指南

获取API密钥

在Cal.com注册一个新账户。
进入设置 > 开发者 > API密钥。
生成一个新的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 .

📚 详细文档

工具

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。

📄 许可证

此MCP服务器根据MIT License授权。这意味着您可以自由地使用、修改和分发软件，但需遵守MIT License的条款和条件。有关详细信息，请参阅项目仓库中的LICENSE文件。

Cal.com Calendar