Calendly Skill
Interact with Calendly scheduling via MCP-generated CLI.
Note: Scheduling API features (list-event-types, get-event-type-availability, schedule-event) will be available once calendly-mcp-server v2.0.0 is published to npm. Current CLI uses v1.0.0 for portability.
Quick Start
CODEBLOCK0
Available Commands
User Info
- -
get-current-user - Get authenticated user details
Events
- -
list-events - List scheduled events (requires --user-uri) - INLINECODE2 - Get event details (requires --event-uuid)
- INLINECODE3 - Cancel an event (requires --event-uuid, optional --reason)
Invitees
- -
list-event-invitees - List invitees for an event (requires --event-uuid)
Organization
- -
list-organization-memberships - List organization memberships
Configuration
API key can be stored in your environment or .env file:
CODEBLOCK1
Get your Personal Access Token from: https://calendly.com/integrations/api_webhooks
Usage in Moltbot
When user asks about:
- - "What meetings do I have?" →
list-events with --min-start-time (use recent date!) - "Cancel my 2pm meeting" → Find with
list-events (time-filtered), then INLINECODE10 - "Who's attending X meeting?" → INLINECODE11
Note: First time, run calendly get-current-user to obtain your User URI.
Getting Your User URI
Run calendly get-current-user to get your user URI. Example:
CODEBLOCK2
Examples
CODEBLOCK3
Coming Soon: Scheduling API (v2.0)
Once calendly-mcp-server v2.0.0 is published, these commands will be available:
Scheduling Workflow
CODEBLOCK4
Scheduling API Requirements:
- - calendly-mcp-server v2.0.0+ (unreleased as of 2026-01-21)
- Paid Calendly plan (Standard or higher)
To upgrade when v2.0 is published:
CODEBLOCK5
Important: Time Filtering
Always use --min-start-time when querying recent events!
The API returns events oldest-first by default and doesn't support pagination via CLI. Without a time filter, you'll get events from years ago.
CODEBLOCK6
Notes
- - All times in API responses are UTC (convert to Pacific for display)
- Event UUIDs are found in
list-events output - OAuth tools available but not needed with Personal Access Token
- No pagination support in CLI - use time filters instead
Generated: 2026-01-20
Updated: 2026-01-21 (Portable CLI with npm v1.0.0; v2.0 scheduling features pending upstream publish)
Source: meAmitPatil/calendly-mcp-server via mcporter
Calendly 技能
通过 MCP 生成的 CLI 与 Calendly 日程安排进行交互。
注意： 日程安排 API 功能（list-event-types、get-event-type-availability、schedule-event）将在 calendly-mcp-server v2.0.0 发布到 npm 后可用。当前 CLI 使用 v1.0.0 以确保可移植性。
快速开始
bash
获取你的 Calendly 个人资料（返回用户 URI）
calendly get-current-user
列出近期事件（查询近期事件时务必使用 --min-start-time！）
calendly list-events --user-uri <你的用户URI> --min-start-time 2026-01-20T00:00:00Z
获取事件详情
calendly get-event --event-uuid
取消事件
calendly cancel-event --event-uuid --reason 需要重新安排
可用命令
用户信息
- - get-current-user - 获取已认证用户的详细信息
事件
- - list-events - 列出已安排的事件（需要 --user-uri）
- get-event - 获取事件详情（需要 --event-uuid）
- cancel-event - 取消事件（需要 --event-uuid，可选 --reason）
受邀人
- - list-event-invitees - 列出事件的受邀人（需要 --event-uuid）
组织
- - list-organization-memberships - 列出组织成员关系
配置
API 密钥可以存储在环境变量或 .env 文件中：
bash
export CALENDLYAPIKEY=<你的个人访问令牌>
或者在 ~/.moltbot/.env 或 ~/.clawdbot/.env 中
从以下地址获取你的个人访问令牌：https://calendly.com/integrations/api_webhooks
在 Moltbot 中使用
当用户询问：
- - 我有哪些会议？ → 使用 --min-start-time（使用近期日期！）执行 list-events
- 取消我下午2点的会议 → 使用 list-events（按时间过滤）查找，然后执行 cancel-event
- 谁在参加 X 会议？ → 执行 list-event-invitees
注意： 首次使用时，运行 calendly get-current-user 获取你的用户 URI。
获取你的用户 URI
运行 calendly get-current-user 获取你的用户 URI。示例：
json
{
resource: {
uri: https://api.calendly.com/users/<你的用户UUID>,
scheduling_url: https://calendly.com/<你的用户名>
}
}
示例
bash
列出接下来的10个事件
calendly list-events \
--user-uri <你的用户URI> \
-o json | jq .
获取事件详情
calendly get-event \
--event-uuid <事件UUID> \
-o json
带原因取消
calendly cancel-event \
--event-uuid <事件UUID> \
--reason 因冲突需要重新安排
即将推出：日程安排 API（v2.0）
一旦 calendly-mcp-server v2.0.0 发布，以下命令将可用：
日程安排工作流
bash
1. 列出可用的事件类型
calendly list-event-types
2. 检查特定事件类型的可用性
calendly get-event-type-availability --event-type <事件类型URI>
3. 安排会议（需要付费 Calendly 计划）
calendly schedule-event \
--event-type <事件类型URI> \
--start-time 2026-01-25T19:00:00Z \
--invitee-email client@company.com \
--invitee-name John Smith \
--invitee-timezone America/New_York
日程安排 API 要求：
- - calendly-mcp-server v2.0.0+（截至2026-01-21尚未发布）
- 付费 Calendly 计划（标准版或更高版本）
v2.0 发布后升级方法：
bash
cd ~/clawd/skills/calendly
MCPORTER_CONFIG=./mcporter.json npx mcporter@latest generate-cli --server calendly --output calendly
重要提示：时间过滤
查询近期事件时务必使用 --min-start-time！
API 默认按最早时间优先返回事件，且 CLI 不支持分页。如果不使用时间过滤，你将获得多年前的事件。
bash
最近7天
calendly list-events --user-uri --min-start-time $(date -u -d 7 days ago +%Y-%m-%dT00:00:00Z)
本周
calendly list-events --user-uri --min-start-time 2026-01-20T00:00:00Z --max-start-time 2026-01-27T23:59:59Z
仅未来事件
calendly list-events --user-uri --min-start-time $(date -u +%Y-%m-%dT%H:%M:%SZ)
注意事项
- - API 响应中的所有时间均为 UTC（显示时需转换为太平洋时间）
- 事件 UUID 可在 list-events 输出中找到
- OAuth 工具可用，但使用个人访问令牌时无需使用
- CLI 不支持分页 - 请使用时间过滤代替
生成日期： 2026-01-20
更新日期： 2026-01-21（可移植 CLI 使用 npm v1.0.0；v2.0 日程安排功能待上游发布）
来源： meAmitPatil/calendly-mcp-server 通过 mcporter
