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