名称： calendly
描述： Calendly 日程安排集成。通过 Calendly API 列出事件、检查可用性、管理会议。

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 以保证可移植性。

快速开始

# 获取您的 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 <事件UUID>

# 取消事件
calendly cancel-event --event-uuid <事件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 文件中：

export CALENDLY_API_KEY="<您的个人访问令牌>"
# 或存储在 ~/.moltbot/.env 或 ~/.clawdbot/.env 中

从以下地址获取您的个人访问令牌：https://calendly.com/integrations/api_webhooks

在 Moltbot 中使用

当用户询问时：
- “我有哪些会议？” → 使用 list-events 并指定 --min-start-time（使用近期日期！）
- “取消我下午 2 点的会议” → 先用 list-events（按时间过滤）查找，然后用 cancel-event 取消
- “谁将参加 X 会议？” → 使用 list-event-invitees

注意： 首次使用时，请运行 calendly get-current-user 以获取您的用户 URI。

获取您的用户 URI

运行 calendly get-current-user 以获取您的用户 URI。示例：

{
  "resource": {
    "uri": "https://api.calendly.com/users/<您的用户UUID>",
    "scheduling_url": "https://calendly.com/<您的用户名>"
  }
}

示例

# 列出接下来的 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 发布，以下命令将可用：

日程安排工作流

# 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 发布时，按以下方式升级：

cd ~/clawd/skills/calendly
MCPORTER_CONFIG=./mcporter.json npx mcporter@latest generate-cli --server calendly --output calendly

重要：时间过滤

查询近期事件时，务必使用 --min-start-time！

API 默认按时间从早到晚返回事件，且 CLI 不支持分页。如果不使用时间过滤器，您将获得多年前的事件。

# 过去 7 天
calendly list-events --user-uri "<URI>" --min-start-time "$(date -u -d '7 days ago' +%Y-%m-%dT00:00:00Z)"

# 本周
calendly list-events --user-uri "<URI>" --min-start-time "2026-01-20T00:00:00Z" --max-start-time "2026-01-27T23:59:59Z"

# 仅未来事件
calendly list-events --user-uri "<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（使用 npm v1.0.0 的可移植 CLI；v2.0 的日程安排功能待上游发布）
来源： meAmitPatil/calendly-mcp-server via mcporter