calcom-cli
When To Use This Skill
Use the calcom-cli skill when you need to:
- - Manage Cal.com schedules (create, update, delete availability)
- View, cancel, reschedule, or confirm bookings
- Create and manage event types
- Check available time slots for scheduling
- View user profile information
Capabilities
- - Schedules: List, create, update, delete availability schedules with timezone support
- Bookings: List, view, cancel, reschedule, and confirm bookings with filters (status, date range, attendee)
- Event Types: Create and manage event types with custom durations, buffers, and booking fields
- Slots: Query available time slots for booking
- Profile: View current user profile details
Common Use Cases
- - "List all my upcoming bookings"
- "Cancel booking xyz with reason 'Schedule conflict'"
- "Create a new 30-minute meeting event type"
- "Show available slots for tomorrow between 9am and 5pm"
- "Update my work hours schedule to use Pacific timezone"
- "Reschedule booking abc to next Tuesday at 2pm"
Setup
If calcom-cli is not installed, install it from GitHub:
CODEBLOCK0
If calcom-cli is not found, install and build it:
CODEBLOCK1
INLINECODE3 adds ~/.local/bin to PATH automatically. The CLI is available in the next command.
Always use --json flag when calling commands programmatically.
Working Rules
- - Always use
--json for agent-driven calls so downstream steps can parse the result. - Start with
--help if the exact action or flags are unclear instead of guessing. - Prefer read commands first when you need to inspect current state before mutating data.
Authentication
CODEBLOCK2
Auth commands: auth set <token>, auth show, auth remove, INLINECODE11
Token is stored in ~/.config/tokens/calcom-cli.txt.
Resources
schedules
Manage availability schedules.
- -
list - List all schedules - INLINECODE14 - Get a specific schedule
- INLINECODE15 - Create new schedule
- INLINECODE16 - Update schedule
- INLINECODE17 - Delete schedule
bookings
Manage meeting bookings.
- -
list [--status] [--after-start] [--before-end] [--attendee-email] - List bookings with filters - INLINECODE19 - Get booking details
- INLINECODE20 - Cancel a booking
- INLINECODE21 - Reschedule booking
- INLINECODE22 - Confirm a pending booking
event-types
Manage event type configurations.
- -
list [--event-slug] - List all event types - INLINECODE24 - Get event type details
- INLINECODE25 - Create event type
- INLINECODE26 - Update event type
- INLINECODE27 - Delete event type
slots
Query available time slots.
- -
list --start-time <datetime> --end-time <datetime> [--event-type-id] - Get available slots
me
View user profile.
- -
get - Get current user profile
Output Format
INLINECODE30 returns a standardized envelope:
CODEBLOCK3
On error: INLINECODE31
Quick Reference
CODEBLOCK4
Global Flags
All commands support: --json, --format <text|json|csv|yaml>, --verbose, --no-color, INLINECODE36
Exit codes: 0 = success, 1 = API error, 2 = usage error
技能名称: calcom
详细描述:
calcom-cli
何时使用此技能
当您需要以下操作时,请使用 calcom-cli 技能:
- - 管理 Cal.com 日程(创建、更新、删除可用性)
- 查看、取消、重新安排或确认预订
- 创建和管理活动类型
- 检查可用的预约时间段
- 查看用户个人资料信息
功能
- - 日程:列出、创建、更新、删除支持时区的可用性日程
- 预订:使用筛选条件(状态、日期范围、参与者)列出、查看、取消、重新安排和确认预订
- 活动类型:创建和管理具有自定义时长、缓冲时间和预订字段的活动类型
- 时间段:查询可用的预约时间段
- 个人资料:查看当前用户的个人资料详情
常见用例
- - 列出我所有即将到来的预订
- 取消预订 xyz,原因为日程冲突
- 创建一个新的30分钟会议活动类型
- 显示明天上午9点到下午5点之间的可用时间段
- 将我的工作时间日程更新为太平洋时区
- 将预订 abc 重新安排到下周二下午2点
设置
如果 calcom-cli 未安装,请从 GitHub 安装:
bash
npx api2cli install Melvynx/calcom-cli
如果找不到 calcom-cli,请安装并构建:
bash
bun --version || curl -fsSL https://bun.sh/install | bash
npx api2cli bundle calcom
npx api2cli link calcom
api2cli link 会自动将 ~/.local/bin 添加到 PATH。CLI 可在下一个命令中使用。
以编程方式调用命令时,始终使用 --json 标志。
工作规则
- - 对于代理驱动的调用,始终使用 --json,以便下游步骤可以解析结果。
- 如果不确定具体操作或标志,请先使用 --help,而不是猜测。
- 在修改数据之前,如果需要检查当前状态,优先使用读取命令。
身份验证
bash
calcom-cli auth set your-token
calcom-cli auth test
认证命令:auth set 、auth show、auth remove、auth test
令牌存储在 ~/.config/tokens/calcom-cli.txt 中。
资源
schedules
管理可用性日程。
- - list - 列出所有日程
- get - 获取特定日程
- create --name --time-zone - 创建新日程
- update [--name] [--time-zone] - 更新日程
- delete - 删除日程
bookings
管理会议预订。
- - list [--status] [--after-start] [--before-end] [--attendee-email] - 使用筛选条件列出预订
- get - 获取预订详情
- cancel [--cancellation-reason] - 取消预订
- reschedule --start [--reschedule-reason] - 重新安排预订
- confirm - 确认待处理的预订
event-types
管理活动类型配置。
- - list [--event-slug] - 列出所有活动类型
- get - 获取活动类型详情
- create --title --slug --length-in-minutes - 创建活动类型
- update [options] - 更新活动类型
- delete - 删除活动类型
slots
查询可用时间段。
- - list --start-time --end-time [--event-type-id] - 获取可用时间段
me
查看用户资料。
输出格式
--json 返回标准化的信封格式:
json
{ ok: true, data: { ... }, meta: { total: 42 } }
错误时:{ ok: false, error: { message: ..., status: 401 } }
快速参考
bash
calcom-cli --help # 列出所有资源和全局标志
calcom-cli --help # 列出资源的所有操作
calcom-cli --help # 显示特定操作的标志
全局标志
所有命令支持:--json、--format 、--verbose、--no-color、--no-header
退出代码:0 = 成功,1 = API 错误,2 = 使用错误