内容
# @mnicole-dev/calcom-mcp-server
用于 [Cal.com API v2](https://cal.com/docs/api-reference/v2/introduction) 的 MCP 服务器。提供了 24 种工具，涵盖预订、事件类型、可用时间段、时间表、日历、个人资料和离职管理。
## 工具列表
### 预订（7）
| 工具 | 描述 |
|------|-------------|
| `list-bookings` | 列出预订，支持筛选（状态、日期范围、参会者、事件类型） |
| `get-booking` | 通过 UID 获取预订 |
| `create-booking` | 创建新的预订 |
| `cancel-booking` | 取消预订 |
| `reschedule-booking` | 将预订重新安排到新时间 |
| `confirm-booking` | 确认待处理的预订 |
| `decline-booking` | 拒绝待处理的预订 |
### 事件类型（5）
| 工具 | 描述 |
|------|-------------|
| `list-event-types` | 列出所有事件类型 |
| `get-event-type` | 通过 ID 获取事件类型 |
| `create-event-type` | 创建新的事件类型 |
| `update-event-type` | 更新现有的事件类型 |
| `delete-event-type` | 删除事件类型 |
### 时间段（1）
| 工具 | 描述 |
|------|-------------|
| `get-available-slots` | 获取日期范围内的可用预订时间段 |
### 时间表（5）
| 工具 | 描述 |
|------|-------------|
| `list-schedules` | 列出所有可用时间表 |
| `get-schedule` | 通过 ID 获取时间表 |
| `create-schedule` | 创建新的可用时间表 |
| `update-schedule` | 更新时间表 |
| `delete-schedule` | 删除时间表 |
### 个人资料（1）
| 工具 | 描述 |
|------|-------------|
| `get-me` | 获取已认证的用户个人资料 |
### 日历（2）
| 工具 | 描述 |
|------|-------------|
| `list-calendars` | 列出连接的日历 |
| `get-busy-times` | 从日历获取繁忙时间块 |
### 离职管理（3）
| 工具 | 描述 |
|------|-------------|
| `list-out-of-office` | 列出所有离职管理记录 |
| `create-out-of-office` | 创建离职管理记录 |
| `delete-out-of-office` | 删除离职管理记录 |
## 设置
### 获取 API 密钥
1. 登录 [Cal.com](https://app.cal.com)
2. 进入 **设置** → **开发者** → **API 密钥**
3. 创建新的 API 密钥
### 配置 Claude 桌面版
将以下内容添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"calcom": {
"command": "npx",
"args": ["-y", "@mnicole-dev/calcom-mcp-server"],
"env": {
"CAL_API_KEY": "此处替换您的 API 密钥"
}
}
}
}
```
## 开发
```bash
pnpm install
pnpm build
CAL_API_KEY=您的密钥 pnpm dev
```
