Calendly 技能

通过 MCP 生成的 CLI 与 Calendly 日程安排进行交互。

注意：日程安排 API 功能（列出事件类型、获取事件类型可用性、安排事件）将在 calendly-mcp-server v2.0.0 发布到 npm 后可用。当前 CLI 使用 v1.0.0 以确保可移植性。

快速开始

# Get your Calendly profile (returns user URI)
calendly get-current-user

# List RECENT events (always use --min-start-time for recent queries!)
calendly list-events --user-uri "<YOUR_USER_URI>" --min-start-time "2026-01-20T00:00:00Z"

# Get event details
calendly get-event --event-uuid <UUID>

# Cancel an event
calendly cancel-event --event-uuid <UUID> --reason "Rescheduling needed"

可用命令

用户信息

• 获取当前用户- 获取已认证用户的详细信息

事件

• 列出事件- 列出已安排的事件（需要 --user-uri 参数）
• 获取事件- 获取事件详情（需要 --event-uuid 参数）
• 取消事件- 取消一个事件（需要 --event-uuid 参数，可选 --reason 参数）

受邀者

• 列出事件受邀者- 列出某个事件的受邀者（需要 --event-uuid 参数）

组织

• 列出组织成员资格- 列出组织成员资格

配置

API 密钥可以存储在您的环境或.env文件中：

export CALENDLY_API_KEY="<your-pat-token>"
# Or in ~/.moltbot/.env or ~/.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/<YOUR_USER_UUID>",
    "scheduling_url": "https://calendly.com/<your-username>"
  }
}

示例

# List next 10 events
calendly list-events \
  --user-uri "<YOUR_USER_URI>" \
  -o json | jq .

# Get event details
calendly get-event \
  --event-uuid "<EVENT_UUID>" \
  -o json

# Cancel with reason
calendly cancel-event \
  --event-uuid "<EVENT_UUID>" \
  --reason "Rescheduling due to conflict"

即将推出：日程安排API（v2.0版）

一旦calendly-mcp-server v2.0.0发布，这些命令将可用：

日程安排工作流程

# 1. List available event types
calendly list-event-types

# 2. Check availability for a specific event type
calendly get-event-type-availability --event-type "<EVENT_TYPE_URI>"

# 3. Schedule a meeting (requires paid Calendly plan)
calendly schedule-event \
  --event-type "<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进行分页。如果不使用时间筛选，您将获得多年前的事件。

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

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

# Future events only
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（便携式CLI使用npm v1.0.0；v2.0调度功能待上游发布）
来源：meAmitPatil/calendly-mcp-server via mcporter