calendly-automation

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Calendly Automation via Rube MCP

通过Rube MCP实现Calendly自动化

Automate Calendly operations including event listing, invitee management, scheduling link creation, availability queries, and organization administration through Composio's Calendly toolkit.

通过Composio的Calendly工具包，实现Calendly操作的自动化，包括活动列出、参会者管理、预约链接创建、可用性查询以及组织管理。

Prerequisites

前提条件

Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
Active Calendly connection via
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
calendly
```
Always call
```
RUBE_SEARCH_TOOLS
```
first to get current tool schemas
Many operations require the user's Calendly URI, obtained via
```
CALENDLY_GET_CURRENT_USER
```

已连接Rube MCP（RUBE_SEARCH_TOOLS可用）
通过
```
RUBE_MANAGE_CONNECTIONS
```
并使用工具包
```
calendly
```
完成Calendly的激活连接
请始终先调用
```
RUBE_SEARCH_TOOLS
```
以获取最新的工具模式
许多操作需要用户的Calendly URI，可通过
```
CALENDLY_GET_CURRENT_USER
```
获取

Setup

设置步骤

Get Rube MCP: Add

https://rube.app/mcp

as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

Verify Rube MCP is available by confirming
```
RUBE_SEARCH_TOOLS
```
responds
Call
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
calendly
```
If connection is not ACTIVE, follow the returned auth link to complete Calendly OAuth
Confirm connection status shows ACTIVE before running any workflows

获取Rube MCP：在客户端配置中添加

https://rube.app/mcp

作为MCP服务器。无需API密钥——只需添加端点即可使用。

通过确认
```
RUBE_SEARCH_TOOLS
```
能正常响应，验证Rube MCP是否可用
调用
```
RUBE_MANAGE_CONNECTIONS
```
并指定工具包
```
calendly
```
如果连接状态未显示为ACTIVE，请按照返回的授权链接完成Calendly OAuth认证
在运行任何工作流之前，确认连接状态为ACTIVE

Core Workflows

核心工作流

1. List and View Scheduled Events

1. 列出并查看已预约活动

When to use: User wants to see their upcoming, past, or filtered Calendly events

Tool sequence:

```
CALENDLY_GET_CURRENT_USER
```
- Get authenticated user URI and organization URI [Prerequisite]
```
CALENDLY_LIST_EVENTS
```
- List events scoped by user, organization, or group [Required]
```
CALENDLY_GET_EVENT
```
- Get detailed info for a specific event by UUID [Optional]

Key parameters:

user

: Full Calendly API URI (e.g.,

https://api.calendly.com/users/{uuid}

) - NOT

"me"

```
organization
```
: Full organization URI for org-scoped queries
```
status
```
:
```
"active"
```
or
```
"canceled"
```

min_start_time

max_start_time

: UTC timestamps (e.g.,

2024-01-01T00:00:00.000000Z

)

```
invitee_email
```
: Filter events by invitee email (filter only, not a scope)
```
sort
```
:
```
"start_time:asc"
```
or
```
"start_time:desc"
```
```
count
```
: Results per page (default 20)
```
page_token
```
: Pagination token from previous response

Pitfalls:

Exactly ONE of
```
user
```
,
```
organization
```
, or
```
group
```
must be provided - omitting or combining scopes fails
The
```
user
```
parameter requires the full API URI, not
```
"me"
```
- use
```
CALENDLY_GET_CURRENT_USER
```
first
```
invitee_email
```
is a filter, not a scope; you still need one of user/organization/group
Pagination uses
```
count
```
+
```
page_token
```
; loop until
```
page_token
```
is absent for complete results
Admin rights may be needed for organization or group scope queries

适用场景：用户希望查看即将到来、已结束或经过筛选的Calendly活动

工具执行序列:

```
CALENDLY_GET_CURRENT_USER
```
- 获取已认证用户的URI和组织URI [前提条件]
```
CALENDLY_LIST_EVENTS
```
- 按用户、组织或组范围列出活动 [必需]
```
CALENDLY_GET_EVENT
```
- 通过UUID获取特定活动的详细信息 [可选]

关键参数:

```
user
```
: Calendly API完整URI（例如：
```
https://api.calendly.com/users/{uuid}
```
）- 不可使用
```
"me"
```
```
organization
```
: 用于组织范围查询的完整组织URI
```
status
```
:
```
"active"
```
或
```
"canceled"
```

min_start_time

max_start_time

: UTC时间戳（例如：

2024-01-01T00:00:00.000000Z

）

```
invitee_email
```
: 按参会者邮箱筛选活动（仅为筛选条件，非范围参数）
```
sort
```
:
```
"start_time:asc"
```
或
```
"start_time:desc"
```
```
count
```
: 每页结果数量（默认20）
```
page_token
```
: 上一次响应中的分页令牌

注意事项:

必须且只能提供
```
user
```
、
```
organization
```
或
```
group
```
中的一个参数——省略或组合多个范围参数会导致失败
```
user
```
参数需要完整的API URI，不可使用
```
"me"
```
——请先调用
```
CALENDLY_GET_CURRENT_USER
```
获取
```
invitee_email
```
是筛选条件，而非范围参数；仍需提供user/organization/group中的一个
使用
```
count
```
+
```
page_token
```
进行分页，直到
```
page_token
```
不存在时获取完整结果
组织或组范围的查询可能需要管理员权限

2. Manage Event Invitees

2. 管理活动参会者

When to use: User wants to see who is booked for events or get invitee details

Tool sequence:

```
CALENDLY_LIST_EVENTS
```
- Find the target event(s) [Prerequisite]
```
CALENDLY_LIST_EVENT_INVITEES
```
- List all invitees for a specific event [Required]
```
CALENDLY_GET_EVENT_INVITEE
```
- Get detailed info for a single invitee [Optional]

Key parameters:

```
uuid
```
: Event UUID (for
```
LIST_EVENT_INVITEES
```
)
```
event_uuid
```
+
```
invitee_uuid
```
: Both required for
```
GET_EVENT_INVITEE
```
```
email
```
: Filter invitees by email address
```
status
```
:
```
"active"
```
or
```
"canceled"
```
```
sort
```
:
```
"created_at:asc"
```
or
```
"created_at:desc"
```
```
count
```
: Results per page (default 20)

Pitfalls:

The
```
uuid
```
parameter for
```
CALENDLY_LIST_EVENT_INVITEES
```
is the event UUID, not the invitee UUID
Paginate using
```
page_token
```
until absent for complete invitee lists
Canceled invitees are excluded by default; use
```
status: "canceled"
```
to see them

适用场景：用户希望查看活动的已预约人员或获取参会者详细信息

工具执行序列:

```
CALENDLY_LIST_EVENTS
```
- 找到目标活动 [前提条件]
```
CALENDLY_LIST_EVENT_INVITEES
```
- 列出特定活动的所有参会者 [必需]
```
CALENDLY_GET_EVENT_INVITEE
```
- 获取单个参会者的详细信息 [可选]

关键参数:

```
uuid
```
: 活动UUID（用于
```
LIST_EVENT_INVITEES
```
）
```
event_uuid
```
+
```
invitee_uuid
```
: 调用
```
GET_EVENT_INVITEE
```
时两者均为必需参数
```
email
```
: 按邮箱地址筛选参会者
```
status
```
:
```
"active"
```
或
```
"canceled"
```
```
sort
```
:
```
"created_at:asc"
```
或
```
"created_at:desc"
```
```
count
```
: 每页结果数量（默认20）

注意事项:

```
CALENDLY_LIST_EVENT_INVITEES
```
中的
```
uuid
```
参数是活动UUID，而非参会者UUID
使用
```
page_token
```
进行分页，直到不存在时获取完整的参会者列表
默认会排除已取消预约的参会者；需使用
```
status: "canceled"
```
才能查看

3. Create Scheduling Links and Check Availability

3. 创建预约链接并检查可用性

When to use: User wants to generate a booking link or check available time slots

Tool sequence:

```
CALENDLY_GET_CURRENT_USER
```
- Get user URI [Prerequisite]
```
CALENDLY_LIST_USER_S_EVENT_TYPES
```
- List available event types [Required]
```
CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES
```
- Check available slots for an event type [Optional]
```
CALENDLY_CREATE_SCHEDULING_LINK
```
- Generate a single-use scheduling link [Required]
```
CALENDLY_LIST_USER_AVAILABILITY_SCHEDULES
```
- View user's availability schedules [Optional]

Key parameters:

owner

: Event type URI (e.g.,

https://api.calendly.com/event_types/{uuid}

)

```
owner_type
```
:
```
"EventType"
```
(default)
```
max_event_count
```
: Must be exactly
```
1
```
for single-use links
```
start_time
```
/
```
end_time
```
: UTC timestamps for availability queries (max 7-day range)
```
active
```
: Boolean to filter active/inactive event types
```
user
```
: User URI for event type listing

Pitfalls:

```
CALENDLY_CREATE_SCHEDULING_LINK
```
can return 403 if token lacks rights or owner URI is invalid
```
CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES
```
requires UTC timestamps and max 7-day range; split longer searches
Available times results are NOT paginated - all results returned in one response
Event type URIs must be full API URIs (e.g.,
```
https://api.calendly.com/event_types/...
```
)

适用场景：用户希望生成预约链接或查询可用时间段

工具执行序列:

```
CALENDLY_GET_CURRENT_USER
```
- 获取用户URI [前提条件]
```
CALENDLY_LIST_USER_S_EVENT_TYPES
```
- 列出可用的活动类型 [必需]
```
CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES
```
- 查询特定活动类型的可用时段 [可选]
```
CALENDLY_CREATE_SCHEDULING_LINK
```
- 生成单次使用的预约链接 [必需]
```
CALENDLY_LIST_USER_AVAILABILITY_SCHEDULES
```
- 查看用户的可用时间安排 [可选]

关键参数:

owner

: 活动类型URI（例如：

https://api.calendly.com/event_types/{uuid}

）

```
owner_type
```
:
```
"EventType"
```
（默认值）
```
max_event_count
```
: 生成单次使用链接时必须设为
```
1
```
```
start_time
```
/
```
end_time
```
: 用于可用性查询的UTC时间戳（最大时间范围为7天）
```
active
```
: 布尔值，用于筛选活跃/非活跃的活动类型
```
user
```
: 用于列出活动类型的用户URI

注意事项:

如果令牌权限不足或owner URI无效，
```
CALENDLY_CREATE_SCHEDULING_LINK
```
可能返回403错误
```
CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES
```
要求使用UTC时间戳且最大时间范围为7天；如需查询更长时间，请拆分为多次调用
可用时段的查询结果不支持分页——所有结果会在一次响应中返回
活动类型URI必须是完整的API URI（例如：
```
https://api.calendly.com/event_types/...
```
）

4. Cancel Events

4. 取消活动

When to use: User wants to cancel a scheduled Calendly event

Tool sequence:

```
CALENDLY_LIST_EVENTS
```
- Find the event to cancel [Prerequisite]
```
CALENDLY_GET_EVENT
```
- Confirm event details before cancellation [Prerequisite]
```
CALENDLY_LIST_EVENT_INVITEES
```
- Check who will be affected [Optional]
```
CALENDLY_CANCEL_EVENT
```
- Cancel the event [Required]

Key parameters:

```
uuid
```
: Event UUID to cancel
```
reason
```
: Optional cancellation reason (may be included in notification to invitees)

Pitfalls:

Cancellation is IRREVERSIBLE - always confirm with the user before calling
Cancellation may trigger notifications to invitees
Only active events can be canceled; already-canceled events return errors
Get explicit user confirmation before executing
```
CALENDLY_CANCEL_EVENT
```

适用场景：用户希望取消已预约的Calendly活动

工具执行序列:

```
CALENDLY_LIST_EVENTS
```
- 找到要取消的活动 [前提条件]
```
CALENDLY_GET_EVENT
```
- 取消前确认活动详情 [前提条件]
```
CALENDLY_LIST_EVENT_INVITEES
```
- 查看受影响的参会者 [可选]
```
CALENDLY_CANCEL_EVENT
```
- 取消活动 [必需]

关键参数:

```
uuid
```
: 要取消的活动UUID
```
reason
```
: 可选的取消原因（可能会包含给参会者的通知中）

注意事项:

取消操作不可撤销——执行
```
CALENDLY_CANCEL_EVENT
```
前请务必与用户确认
取消操作可能会向参会者发送通知
仅可取消活跃状态的活动；已取消的活动会返回错误
执行
```
CALENDLY_CANCEL_EVENT
```
前请获取用户的明确确认

5. Manage Organization and Invitations

5. 管理组织与邀请

When to use: User wants to invite members, manage organization, or handle org invitations

Tool sequence:

```
CALENDLY_GET_CURRENT_USER
```
- Get user and organization context [Prerequisite]
```
CALENDLY_GET_ORGANIZATION
```
- Get organization details [Optional]
```
CALENDLY_LIST_ORGANIZATION_INVITATIONS
```
- Check existing invitations [Optional]
```
CALENDLY_CREATE_ORGANIZATION_INVITATION
```
- Send an org invitation [Required]

CALENDLY_REVOKE_USER_S_ORGANIZATION_INVITATION

- Revoke a pending invitation [Optional]

```
CALENDLY_REMOVE_USER_FROM_ORGANIZATION
```
- Remove a member [Optional]

Key parameters:

```
uuid
```
: Organization UUID
```
email
```
: Email address of user to invite
```
status
```
: Filter invitations by
```
"pending"
```
,
```
"accepted"
```
, or
```
"declined"
```

Pitfalls:

Only org owners/admins can manage invitations and removals; others get authorization errors
Duplicate active invitations for the same email are rejected - check existing invitations first
Organization owners cannot be removed via
```
CALENDLY_REMOVE_USER_FROM_ORGANIZATION
```
Invitation statuses include pending, accepted, declined, and revoked - handle each appropriately

适用场景：用户希望邀请成员、管理组织或处理组织邀请

工具执行序列:

```
CALENDLY_GET_CURRENT_USER
```
- 获取用户和组织上下文 [前提条件]
```
CALENDLY_GET_ORGANIZATION
```
- 获取组织详情 [可选]
```
CALENDLY_LIST_ORGANIZATION_INVITATIONS
```
- 查看现有邀请 [可选]
```
CALENDLY_CREATE_ORGANIZATION_INVITATION
```
- 发送组织邀请 [必需]

CALENDLY_REVOKE_USER_S_ORGANIZATION_INVITATION

- 撤销待处理的邀请 [可选]

```
CALENDLY_REMOVE_USER_FROM_ORGANIZATION
```
- 移除组织成员 [可选]

关键参数:

```
uuid
```
: 组织UUID
```
email
```
: 被邀请用户的邮箱地址
```
status
```
: 按
```
"pending"
```
、
```
"accepted"
```
或
```
"declined"
```
筛选邀请

注意事项:

仅组织所有者/管理员可管理邀请和成员移除；其他用户会收到权限错误
同一邮箱的重复活跃邀请会被拒绝——请先检查现有邀请
无法通过
```
CALENDLY_REMOVE_USER_FROM_ORGANIZATION
```
移除组织所有者
邀请状态包括pending（待处理）、accepted（已接受）、declined（已拒绝）和revoked（已撤销）——请分别处理每种状态

Common Patterns

通用模式

ID Resolution

ID解析

Calendly uses full API URIs as identifiers, not simple IDs:

Current user URI:

CALENDLY_GET_CURRENT_USER

returns

resource.uri

(e.g.,

https://api.calendly.com/users/{uuid}

)

Organization URI: Found in current user response at
```
resource.current_organization
```
Event UUID: Extract from event URI or list responses
Event type URI: From
```
CALENDLY_LIST_USER_S_EVENT_TYPES
```
response

Important: Never use

"me"

as a user parameter in list/filter endpoints. Always resolve to the full URI first.

Calendly使用完整的API URI作为标识符，而非简单ID：

当前用户URI：

CALENDLY_GET_CURRENT_USER

resource.uri

（例如：

https://api.calendly.com/users/{uuid}

）

组织URI：在当前用户响应的
```
resource.current_organization
```
字段中获取
活动UUID：从活动URI或列表响应中提取
活动类型URI：从
```
CALENDLY_LIST_USER_S_EVENT_TYPES
```
响应中获取

重要提示：在列表/筛选端点中，切勿使用

"me"

作为user参数。请始终先解析为完整URI。

Pagination

分页

Most Calendly list endpoints use token-based pagination:

Set
```
count
```
for page size (default 20)
Follow
```
page_token
```
from
```
pagination.next_page_token
```
until absent

Sort with

field:direction

format (e.g.,

start_time:asc

created_at:desc

)

大多数Calendly列表端点使用基于令牌的分页：

设置
```
count
```
指定每页大小（默认20）
跟随
```
pagination.next_page_token
```
中的
```
page_token
```
，直到该令牌不存在

使用

field:direction

格式进行排序（例如：

start_time:asc

、

created_at:desc

）

Time Handling

时间处理

All timestamps must be in UTC format:
```
yyyy-MM-ddTHH:mm:ss.ffffffZ
```
Use
```
min_start_time
```
/
```
max_start_time
```
for date range filtering on events
Available times queries have a maximum 7-day range; split longer searches into multiple calls

所有时间戳必须为UTC格式：
```
yyyy-MM-ddTHH:mm:ss.ffffffZ
```
使用
```
min_start_time
```
/
```
max_start_time
```
对活动进行日期范围筛选
可用时段查询的最大时间范围为7天；如需查询更长时间，请拆分为多次调用

Known Pitfalls

已知注意事项

URI Formats

URI格式

All entity references use full Calendly API URIs (e.g.,
```
https://api.calendly.com/users/{uuid}
```
)
Never pass bare UUIDs where URIs are expected, and never pass
```
"me"
```
to list endpoints
Extract UUIDs from URIs when tools expect UUID parameters (e.g.,
```
CALENDLY_GET_EVENT
```
)

所有实体引用均使用完整的Calendly API URI（例如：
```
https://api.calendly.com/users/{uuid}
```
）
切勿在需要URI的位置传递纯UUID，也切勿在列表端点中传递
```
"me"
```
当工具需要UUID参数时（例如：
```
CALENDLY_GET_EVENT
```
），从URI中提取UUID

Scope Requirements

范围要求

```
CALENDLY_LIST_EVENTS
```
requires exactly one scope (user, organization, or group) - no more, no less
Organization/group scoped queries may require admin privileges
Token scope determines which operations are available; 403 errors indicate insufficient permissions

```
CALENDLY_LIST_EVENTS
```
必须且只能指定一个范围（user、organization或group）——不能多也不能少
组织/组范围的查询可能需要管理员权限
令牌范围决定了可执行的操作；403错误表示权限不足

Data Relationships

数据关系

Events have invitees (attendees who booked)
Event types define scheduling pages (duration, availability rules)
Organizations contain users and groups
Scheduling links are tied to event types, not directly to events

活动关联参会者（已预约的人员）
活动类型定义预约页面（时长、可用时间规则）
组织包含用户和组
预约链接与活动类型绑定，而非直接与活动绑定

Rate Limits

速率限制

Calendly API has rate limits; avoid tight loops over large datasets
Paginate responsibly and add delays for batch operations

Calendly API存在速率限制；避免在大型数据集上进行密集循环
合理分页，并在批量操作中添加延迟

Quick Reference

快速参考

Task	Tool Slug	Key Params
Get current user	`CALENDLY_GET_CURRENT_USER`	(none)
Get user by UUID	`CALENDLY_GET_USER`	`uuid`
List events	`CALENDLY_LIST_EVENTS`	`user` , `status` , `min_start_time`
Get event details	`CALENDLY_GET_EVENT`	`uuid`
Cancel event	`CALENDLY_CANCEL_EVENT`	`uuid` , `reason`
List invitees	`CALENDLY_LIST_EVENT_INVITEES`	`uuid` , `status` , `email`
Get invitee	`CALENDLY_GET_EVENT_INVITEE`	`event_uuid` , `invitee_uuid`
List event types	`CALENDLY_LIST_USER_S_EVENT_TYPES`	`user` , `active`
Get event type	`CALENDLY_GET_EVENT_TYPE`	`uuid`
Check availability	`CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES`	event type URI, `start_time` , `end_time`
Create scheduling link	`CALENDLY_CREATE_SCHEDULING_LINK`	`owner` , `max_event_count`
List availability schedules	`CALENDLY_LIST_USER_AVAILABILITY_SCHEDULES`	user URI
Get organization	`CALENDLY_GET_ORGANIZATION`	`uuid`
Invite to org	`CALENDLY_CREATE_ORGANIZATION_INVITATION`	`uuid` , `email`
List org invitations	`CALENDLY_LIST_ORGANIZATION_INVITATIONS`	`uuid` , `status`
Revoke org invitation	`CALENDLY_REVOKE_USER_S_ORGANIZATION_INVITATION`	org UUID, invitation UUID
Remove from org	`CALENDLY_REMOVE_USER_FROM_ORGANIZATION`	membership UUID

任务	工具标识	关键参数
获取当前用户	`CALENDLY_GET_CURRENT_USER`	无
通过UUID获取用户	`CALENDLY_GET_USER`	`uuid`
列出活动	`CALENDLY_LIST_EVENTS`	`user` , `status` , `min_start_time`
获取活动详情	`CALENDLY_GET_EVENT`	`uuid`
取消活动	`CALENDLY_CANCEL_EVENT`	`uuid` , `reason`
列出参会者	`CALENDLY_LIST_EVENT_INVITEES`	`uuid` , `status` , `email`
获取参会者详情	`CALENDLY_GET_EVENT_INVITEE`	`event_uuid` , `invitee_uuid`
列出活动类型	`CALENDLY_LIST_USER_S_EVENT_TYPES`	`user` , `active`
获取活动类型详情	`CALENDLY_GET_EVENT_TYPE`	`uuid`
检查可用性	`CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES`	活动类型URI, `start_time` , `end_time`
创建预约链接	`CALENDLY_CREATE_SCHEDULING_LINK`	`owner` , `max_event_count`
列出可用时间安排	`CALENDLY_LIST_USER_AVAILABILITY_SCHEDULES`	用户URI
获取组织详情	`CALENDLY_GET_ORGANIZATION`	`uuid`
邀请加入组织	`CALENDLY_CREATE_ORGANIZATION_INVITATION`	`uuid` , `email`
列出组织邀请	`CALENDLY_LIST_ORGANIZATION_INVITATIONS`	`uuid` , `status`
撤销组织邀请	`CALENDLY_REVOKE_USER_S_ORGANIZATION_INVITATION`	组织UUID, 邀请UUID
移除组织成员	`CALENDLY_REMOVE_USER_FROM_ORGANIZATION`	成员UUID