@aiwerk/mcp-server-cal
](https://www.npmjs.com/package/@aiwerk/mcp-server-cal) ](https://www.npmjs.com/package/@aiwerk/mcp-server-cal) 
Cal.com调度MCP服务器-直接从您的AI助手管理预订、活动类型和可用性。
为什么是这个服务器？
将Claude、Cursor或任何兼容MCP的AI连接到您的Cal.com帐户。通过自然语言创建预订、检查可用性、管理活动类型和查看日程。
安装
运行此服务器的两种方法——选择一种合适的方法。
选项1——托管（零设置）
没有本地运行时，您的计算机上没有环境变量——秘密是通过HashiCorp Vault在服务器端进行AES-256-GCM加密的。
- 注册地址： aiwerkmcp.com.
- 安装 Cal.com 从目录中粘贴您的
CAL_API_KEY. - 将您的MCP客户端（Claude.ai、Cursor、Hermes等）指向您的托管端点：
https://bridge.aiwerk.ch/u//mcp用你的Bearer代币。
将显示所有12个工具、3个资源和3个提示。从同一网桥安装其他AIWerk配方。
选项2——自托管（npx）
直接运行-您管理API密钥：
CAL_API_KEY=cal_live_your_api_key_here npx @aiwerk/mcp-server-cal或者将其连接到MCP客户端配置中——请参阅 配置 在......下面
工具
| 工具 | 说明 |
|---|---|
cal_list_bookings | 使用可选过滤器（状态、活动类型、日期范围）列出预订 |
cal_get_booking | 通过UID获取特定预订的详细信息 |
cal_create_booking | 创建新预订（活动类型、与会者信息、时间） |
cal_cancel_booking | 通过UID取消预订 |
cal_reschedule_booking | 将预订重新安排到新时间 |
cal_list_event_types | 列出所有事件类型 |
cal_get_event_type | 按ID获取事件类型详细信息 |
cal_create_event_type | 创建新的事件类型 |
cal_update_event_type | 更新现有事件类型 |
cal_delete_event_type | 删除事件类型 |
cal_get_availability | 检查日期范围内事件类型的可用插槽 |
cal_list_schedules | 列出所有时间表（工作时间/可用性规则） |
资源
资源在人工智能的环境中是自动可用的，无需请求。
| 资源 | URI | 描述 |
|---|---|---|
| 即将到来的预订 | cal://bookings/upcoming | 今天和明天的预订 |
| 事件类型 | cal://event-types | 所有配置的事件类型 |
| 时间表 | cal://schedules | 工作时间和可用性规则 |
提示
常见日程安排任务的现成提示模板。
| 提示 | 描述 |
|---|---|
daily-schedule | 总结今天的日程安排，包括预订和免费时段 |
find-free-slot | 查找特定事件类型的下一个可用时间 |
reschedule-suggestion | 建议重新安排预订的其他时间 |
配置
克劳德桌面版
添加 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"cal": {
"command": "npx",
"args": ["@aiwerk/mcp-server-cal"],
"env": {
"CAL_API_KEY": "cal_live_your_api_key_here"
}
}
}
}光标
添加 .cursor/mcp.json 在您的项目或 ~/.cursor/mcp.json 全球地：
{
"mcpServers": {
"cal": {
"command": "npx",
"args": ["@aiwerk/mcp-server-cal"],
"env": {
"CAL_API_KEY": "cal_live_your_api_key_here"
}
}
}
}OpenClaw/通用配方
{
"name": "cal",
"command": "npx",
"args": ["@aiwerk/mcp-server-cal"],
"env": {
"CAL_API_KEY": "${CAL_API_KEY}"
}
}环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
CAL_API_KEY | 是（调用工具时） | - | Cal.com API密钥(cal_ 或 cal_live_ 前缀） |
CAL_BASE_URL | 没有 | https://api.cal.com/v2 | 覆盖Cal.com API基础URL |
服务器启动并响应 tools/list 没有 CAL_API_KEY。只有在调用实际工具时才需要密钥（懒惰凭据模式）。
获取API密钥
- 首选 Cal.com设置
- 创建新的API密钥
- 复制密钥（以开头
cal_live_用于生产）
安全
- 永远不要将API密钥提交到版本控制
- 使用环境变量或机密管理器
- 服务器只读取
CAL_API_KEY在工具调用时，从不记录
关于AIWerk MCP
部分 AIWerk MCP 平台 --策划、签名的MCP食谱可以作为自托管的npm包，也可以通过我们的多租户托管桥提供(bridge.aiwerk.ch).
其他AIWerk MCP服务器：
- @aiwerk/mcp服务器imap --IMAP/SMTP电子邮件，与提供商无关
- @aiwerk/mcp服务器端 -Wise（TransferWise）个人API，只读
- @aiwerk/mcp服务器clawhub --ClawHub技能目录
浏览完整目录（20多种食谱，包括GitHub、Linear、Notion、Stripe等） aiwerkmcp.com.
贡献
欢迎发布问题和PR！请先打开一个问题以进行更大的更改。
许可证
麻省理工学院- 工作