Calendly MCP Server
A Calendly MCP server/CLI exposing 66 tools (44 reads, 22 confirmation-guarded writes) for scheduling, contacts, recaps, organizations and webhooks.
Users & identity: read the current user or any user by UUID to get canonical URIs.
Scheduled events: list/get events, list invitees, get a single invitee, cancel an event, and create invitees to book real meetings.
No-shows: create, get and delete invitee no-show records.
Event types: list, get, create, update, create one-off event types, and list event type hosts.
Availability: read user schedules, event-type schedules and busy times; list available slots; update event-type availability rules (replaces all rules).
Scheduling links & shares: create single-use scheduling links and customized share links for one-on-one event types.
Contacts: list, get, create, update and delete contacts, including typed custom field values.
Custom fields: list and get contact custom field definitions.
Meeting recaps (Notetaker): list, get, update and delete recaps, plus retrieve transcripts — read-only, no recording or generation.
Organizations: get organization, memberships, invitations, teams; invite, revoke invitations and remove members.
Groups: list and get groups and group relationships.
Routing forms: list forms and submissions, get individual forms/submissions.
Webhooks: create, list, get and delete subscriptions; fetch sample webhook payloads.
Activity & communications: list activity log entries and outgoing communications (Enterprise-level features).
Data compliance: request invitee or scheduled-event data deletion.
Local helper:
list_accountslists named private credential labels without any network call.Safe by default: every write needs explicit confirmation, with read-only/destructive blocking, per-account credentials and bounded pagination.
Provides tools for interacting with the Calendly API v2 (66 tools: 44 reads and 22 confirmed writes), enabling AI agents to look up the current user and event types, check event-type availability, book invitees, read and manage contacts and contact custom field definitions, access Notetaker meeting recaps and transcripts, and inspect organizations, memberships, groups, routing submissions, availability rules and webhook subscriptions. It supports private scoped Personal Access Tokens and REST OAuth grants, named accounts, pagination and quota handling, and requires explicit confirmation for every write operation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Calendly MCP Server find available times for my 30-min intro call this week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Calendly MCP Server & CLI
Calendly MCP server and CLI for Claude Code, Codex and AI agents. 66 tools: 44 reads and 22 confirmed writes for scheduling, contacts, custom fields, Notetaker recaps, transcripts, availability, organizations and webhooks.
One package provides local MCP, the same operations as task CLI commands, and a bundled Claude Desktop .mcpb extension.
Built and maintained by Navid Moazzez. Built on Slipway, which turns one definition of each tool into the MCP server and the CLI. Complete installation and private account setup are in INSTALL.md.
The terminal illustrates shipped scheduling tools with sample data; it is not a verified live account booking.
You need a privately configured scoped PAT or authorized REST OAuth grant. Account roles, paid features and quotas apply. The wrapper preserves AGPL-3.0-or-later; Calendly service charges remain separate. This is a community product.
Calendly already offers an official hosted MCP and a community CLI exists. Our current API coverage and tradeoffs are compared below, without unsupported coverage or efficiency claims.
Two ways to use it
Command line
npm install -g @thenavidm/calendly-mcp-cli@latest
calendly-cli
calendly-cli list-events --help
calendly-cli schema create-invitee
calendly-cli get-current-user --agentConfigure private credentials before account calls. Every write requires --confirm; --yes and --agent do not authorize changes.
MCP server, for your AI app
codex mcp add calendly -- npx -y @thenavidm/calendly-mcp-cli@latestThen ask: Find available slots for the event type I choose, and wait for my booking details. All declared client/OS routes are in INSTALL.md.
Which one
Where you work | Surface |
Claude Code, Codex, Cursor or another shell agent | MCP, CLI or both |
Claude Desktop chat | Local MCP or desktop bundle |
Scripts/CI | CLI or an MCP client |
Remote-URL-only clients with DCR support | Official hosted Calendly MCP |
Related MCP server: Cal.com MCP Server
Features
Capability | CLI | MCP |
Identity and events | get-current-user / list-events | get_current_user / list_events |
Availability and booking | list-event-type-available-times / create-invitee | Same underscore names |
Contacts/custom fields | list-contacts / list-contact-custom-field-definitions | Same shared schemas |
Recaps/transcripts | list-recaps / get-transcript | Same account permissions |
Organizations and webhooks | list-organization-memberships / list-webhooks | Same guarded writes |
Private account labels | list-accounts | list_accounts |
Setup diagnosis | doctor / login | CLI utilities |
Contents
Number | Section | Covers |
1 | Prompts and coverage | |
2 | CLI, MCP and desktop | |
3 | PAT, OAuth, scopes and quotas | |
4 | All declared clients/OS | |
5 | Doctor and first read | |
6 | Arguments, JSON and scripting | |
7 | Actual usage comparison | |
8 | Every operation and argument | |
9 | Booking, contacts, recaps and webhooks | |
10 | Opaque tokens and pending requests | |
11 | Named private grants | |
12 | Confirmation and audit | |
13 | Shared architecture and maintenance | |
14 | Privacy and credentials | |
15 | Credential, safety and tuning | |
16 | Upgrade and revoke | |
17 | Symptoms and remedies | |
18 | Official/community evidence | |
19 | Versions and migration | |
20 | Accordion questions |
1. What you can ask it
Show my current user and the event types I can access.
Find available slots for the selected event type and time zone.
Book the specific slot and invitee I approved.
Read that booking before a requested cancellation.
Find a contact and inspect its custom field definitions before changing it.
Read an authorized meeting recap or transcript, and keep its contents private.
Inspect existing availability rules before the requested replacement.
List organization members, groups, routing submissions and webhook subscriptions.
The current API v2 snapshot has 65 operations. With the local account-label helper, this package exposes 66 tools: 44 reads and 22 confirmed writes. One source serves local MCP, task CLI and the bundled desktop extension. Booking sends normal calendar invites, notifications and workflows. A generated scheduling link is not a booked event.
The official hosted MCP is a strong scheduling option. This package adds local CLI use, private PAT/REST OAuth grants, named accounts, current Contacts/Notetaker operations, schema-derived help and controlled output. Coverage differences are based on reviewed documentation, not a competitor handshake or a measured superiority claim. Live account outcomes and GUI installation remain separately unverified.
2. Quick install
npm install -g @thenavidm/calendly-mcp-cli@latest
calendly-cli --version
calendly-cli login
calendly-cli doctor
calendly-cli toolsManual CLI/local MCP requires Node 22 or newer. Discovery and schemas work without credentials; account reads need private access. The versioned desktop archive bundles production dependencies for a compatible Claude Desktop host. See INSTALL.md for every declared client and OS.
After private configuration:
codex mcp add calendly -- npx -y @thenavidm/calendly-mcp-cli@latest
codex mcp list3. Set up Calendly access
Personal Access Token for your own account
Sign in to the intended Calendly account.
Open Integrations > API and webhooks, or the token page.
Create a named Personal Access Token with the scopes your workflow requires. Copy it once into private storage.
Set
CALENDLY_API_TOKENin private local client/shell settings, orCALENDLY_TOKEN_FILEto an absolute token-only file outside repositories.Run
calendly-cli doctor, thencalendly-cli doctor --networkto check a user read.
See current PAT setup. The token is a Bearer credential, not your Calendly password or browser cookie. Revocation is done in Calendly. GUI clients may not inherit terminal variables; this package does not load .env automatically. On POSIX, a credential file must be owner-only, such as mode 0600; on Windows protect the file and its directory with user-only ACLs. Readers refuse symlinks and files larger than 64 KB. A PAT file takes precedence over the environment PAT, and is cached until restart.
Existing REST OAuth grant
Use your own authorized REST OAuth application when acting for users who consent to your application. This local package does not create an OAuth app, open a browser, host a callback or exchange the first authorization code. login prints setup instructions. Put an existing access token in CALENDLY_ACCESS_TOKEN, or the full grant in a private file selected by CALENDLY_TOKENS_FILE. Do not mix PAT and OAuth settings for the same account.
The token file is a JSON object containing access_token, and optionally refresh_token, client_id, client_secret, created_at (Unix seconds) and expires_in (seconds). Keep all actual values outside model context and repositories. A file is required for automatic refresh; an environment-only access token is never refreshed. The file is read on each request, allowing separate processes to observe a saved rotation. Without valid expiry metadata, one GET 401 can trigger one configured refresh; writes never retry after a 401.
Calendly's single-use refresh-token rule took effect by August 31, 2026. This package refreshes against https://calendly.com/oauth/token, uses Basic client authentication for confidential clients or a body client_id without a secret, and atomically replaces both returned tokens in mode 0600 storage. Concurrent in-process refreshes share one promise, and a per-file .refresh.lock prevents another process from consuming the same token. An existing lock produces a configuration error instead of a second refresh. A crashed process can leave a lock; stop all users of that grant and verify its state before manually removing a stale lock. Never remove an active lock.
A refresh HTTP failure, unknown timeout, incomplete response or failed save requires reauthorization/private storage repair and a restart. No automatic refresh retry occurs. The old refresh token is not deliberately reused after an uncertain result. OAuth access tokens last two hours according to the current token reference; actual expiry metadata governs proactive refresh. Token rotation fixtures are verified; live grants remain unverified.
Scopes, roles and plans
API operation descriptions list their required scopes. :write grants include the family's read access. Start with users:read for doctor, then select only needed scheduling, availability, contacts, meeting_recaps, organization, routing, group or webhook scopes. Webhooks need webhooks:write plus the corresponding event family's read scope. Reauthorize or replace the token if scopes change; an installed command cannot raise permissions.
Direct booking through create_invitee requires a paid Standard-or-higher account. Routing Forms require Teams or higher; Activity Log, outgoing communications and data-compliance deletion require Enterprise and suitable organization permissions. Notetaker endpoints require a paid plan; Contacts/Notetaker data exists only where the account and associated feature provide it. API access does not create transcripts or bypass recording/consent policy. Administrative operations depend on your actual role. See authorization scopes and the current endpoint reference before choosing a plan.
Current request limits
The quota reference documents 50 requests per user/minute on Free and 500 on paid plans. Booking has tighter limits: trial 5/day; paid non-Enterprise 10/minute, 50/hour and 100/day; Enterprise 500/minute. OAuth token requests are limited to 8/user/minute. These are shared provider limits, not allowances reserved for this process.
Default local pacing is 1,300 ms per account/process; multiple account labels for one user and other integrations share that user's quota. GET 429 handling respects Retry-After or X-RateLimit-Reset when the wait is at most ten seconds. Longer waits surface exit 7 so a script can pause explicitly, rather than retry too early. Writes and OAuth refresh requests have zero automatic retries. Every page and retried read consumes quota.
Official hosted MCP is a separate connection
Calendly's official MCP is hosted at https://mcp.calendly.com. It uses OAuth 2.1, PKCE S256, resource discovery and Dynamic Client Registration. It does not accept a PAT or a manually provisioned console client_id/client_secret connection. A client prompting only for static OAuth credentials is incompatible with that documented flow. The documentation search MCP at https://developer.calendly.com/_mcp/server reads docs; it does not operate your account. Keep all three entries distinct.
4. Connect your client
INSTALL.md covers Claude Code, Codex, Claude Desktop extension/manual config, Cursor, VS Code/Copilot, Windsurf, Zed, Gemini CLI, Cline, Docker and other stdio clients on macOS, Windows and Linux. Use npx -y @thenavidm/calendly-mcp-cli@latest as the local server command, with private environment settings. MCP and CLI are two ways to reach the same operations; installing both is optional.
A remote-URL-only client needs a hosted connector such as Calendly's official https://mcp.calendly.com, with DCR OAuth support. This package does not expose a public HTTP relay. Installing a local server does not connect it to a browser-only app. Place SKILL.md in the agent's supported skills folder if using shell commands; npm does not register it automatically. Ask the agent to inspect current help/schemas and assist with private setup without asking you to paste credentials into chat.
5. Check it works
calendly-cli --version
calendly-cli doctor
calendly-cli doctor --network
calendly-cli list-accounts --agent
calendly-cli get-current-user --agentThe local doctor checks configuration. Network doctor reads /users/me and reports success without printing user details; it does not book, cancel or invite anyone. A successful read proves that read's access, not every endpoint/plan permission. Full discovery has 66 tools; read-only has 44. Use the returned canonical user and organization URIs in subsequent filters, rather than substituting a bare UUID.
6. Output, flags and exit codes
Tool names become dashed commands; underscores are accepted too. Path parameter names follow the discovered schema, such as event_uuid → --event-uuid. Body tools accept individual top-level flags, complete --payload JSON, or --payload-file pointing to a regular JSON body file up to 5 MB. Do not mix those body routes. Path/query flags remain separate. Nested objects take JSON and array flags repeat once per item; a whole array is not a single item.
calendly-cli get-event --help
calendly-cli schema create-invitee
calendly-cli list-events --user https://api.calendly.com/users/USER_UUID --count 10 --agent
calendly-cli list-contacts --email user@example.com --count 5 --agentUUIDs and URIs are illustrative; use resources discovered in your own account. Nullable fields require an actual JSON null inside payload; --field null is a string. Nested request properties follow the current schema; unknown top-level body fields are refused. Body-required fields are validated during execution even when the wrapper schema allows an alternative payload route. Operations whose upstream request body is required need body flags or an explicit payload; a deliberately supplied empty object is sent as JSON, never omitted.
Flag | Behavior |
--help / schema COMMAND | Current argument help / full JSON Schema |
--json | Structured JSON |
--compact | One-line JSON |
--agent | Compact JSON and no prompts; never confirms a write |
--select a,b.c | Keep selected fields, including nested objects/arrays |
--no-color / --no-input | Noninteractive house flags |
--yes | Never replaces write confirmation |
--confirm | Confirm only the requested mutation |
--account NAME | Select private local credentials |
--payload JSON / --payload-file PATH | Complete request body, mutually exclusive with body flags |
Exit | Meaning |
0 | Success |
1 | Unexpected error |
2 | Invalid arguments or refused write, an unknown command or a hidden write |
3 | Resource not found |
4 | Authentication/permission failure |
5 | API/transport failure |
7 | Rate limit |
10 | Missing or invalid private configuration |
Results go to stdout, errors as JSON to stderr. Selection changes local output, not the original API response or quota charge. API success is not proof of notification delivery or a completed export.
7. MCP or CLI and token cost
MCP and CLI are built by Slipway from each tool's one definition, so they share schemas, validation and HTTP handlers; there is no second API implementation.
Measured on 2026-10-05 against 2.0.1, the same day, with Claude Code 2.1.286 on Claude Opus 5.5 (one short prompt with and without the server connected, the difference read from the API's own usage figures) and Codex 0.159.3 on gpt-6.1-sol:
Cost | 2.0.1 | 3.0.0 |
Claude Code, every tool loaded, every message | 47,642 | 39,979 |
Claude Code's default, tool search, every message | 1,169 | 1,169 |
| 1,382 | 1,444 |
Codex over the CLI, one task, median of five | 83,991 | 83,073 |
Codex over MCP, the same task, median of five | 48,565 | 48,780 |
The task was "find the command that cancels a scheduled event, and the flags it requires". Every tool loaded costs less because each write's body appeared twice, as its own fields and inside payload, and 3.0.0 writes each repeated part once under $defs. Over the CLI, every 3.0.0 run asked which (255 characters) where 2.0.1's read the full command list (4,745). Over MCP, Codex prints its own TypeScript rendering of the tool list, cut to about 10,000 tokens, and that rendering is longer on 3.0.0, 31,126 tokens against 29,830: Codex leaves the argument descriptions out of a tool whose schema is large, and sharing the repeats brought create_contact and update_contact under that size, so Codex now shows their descriptions. SKILL.md costs 62 more because it now says how approval works over MCP and lists every exit code.
API quota and service costs remain separate, and no other offering was measured.
8. Every tool and argument
All 65 API operations come from the pinned current official OpenAPI. list_accounts is local. Each tool is the same dashed CLI command. Top-level flags and nested request fields are shown below; schema COMMAND returns complete unions, enums and conditional rules. Body requirements apply whether you use individual flags or payload/payload_file.
Tool | REST operation | Mode | Required scope |
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Write, confirms |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Write, confirms |
|
|
| Write, confirms |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Write, confirms |
|
|
| Read |
|
|
| Read |
|
| Local, no network | Read | None |
list_activity_log
calendly-cli list-activity-log · GET /activity_log_entries
Argument | Route | Required | Type | Details |
| query | Yes | string | Return activity log entries from the organization associated with this URI format: |
| query | No | string | Filters entries based on the search term. Supported operators: - |
| query | No | array | Return entries from the user(s) associated with the provided URIs Array items: string. |
| query | No | array | Order results by the specified field and direction. List of {field}:{direction} values. default: |
| query | No | string | Include entries that occurred after this time (sample time format: "2020-01-02T03:04:05.678Z"). This time should use the UTC timezone. format: |
| query | No | string | Include entries that occurred prior to this time (sample time format: "2020-01-02T03:04:05.678Z"). This time should use the UTC timezone. format: |
| query | No | string | The token to pass to get the next portion of the collection |
| query | No | integer | The number of rows to return minimum: |
| query | No | array | The categories of the entries Array items: string. |
| query | No | array | The action(s) associated with the entries Array items: string. |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
get_availability_schedule
calendly-cli get-availability-schedule · GET /user_availability_schedules/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | The UUID of the availability schedule. minLength: |
| Local | No | string | Named private credential label |
list_event_type_availability_schedules
calendly-cli list-event-type-availability-schedules · GET /event_type_availability_schedules
Argument | Route | Required | Type | Details |
| query | Yes | string | The URI associated with the event type format: |
| Local | No | string | Named private credential label |
update_event_type_availability_schedules
calendly-cli update-event-type-availability-schedules · PATCH /event_type_availability_schedules
Argument | Route | Required | Type | Details |
| query | Yes | string | Event Type uri in which to update the availability schedule format: |
| Body | Yes in body | object | Object requires: |
| Nested body | Yes in body | string | The timezone for which this Event Type Availability Schedule is originated in. |
| Nested body | No | array | The rules for an availability schedule. Warning: Updating rules will overwrite all existing rules for the event type. Use the GET endpoint to first retrieve the existing rules and then pass the modified rules to the rules object. Array items: object. |
| Nested body | Yes in body | string | The type of this Availability Rule; can be "wday" or a specific "date". Values: |
| Nested body | Yes in body | array | The intervals to be applied to this Rule. Each interval represents when booking a meeting is allowed. If the interval array is empty, then there is no booking availability for that day. Time is in 24h format (i.e. "17:30") and local to the timezone in the Availability Schedule. Array items: object. |
| Nested body | No | string | Format: |
| Nested body | No | string | Format: |
| Nested body | No | string | The day of the week for which this Rule should be applied to. Values: |
| Nested body | No | string | A specific date in the future that this should be applied to (i.e. "2030-12-31"). pattern: |
| Nested body | No | string | Required when an admin or org owner is making the call to update a specific users availability schedule format: |
| Body | No | string | By default every host on the Event Type shares an identical schedule. default: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
list_availability_schedules
calendly-cli list-availability-schedules · GET /user_availability_schedules
Argument | Route | Required | Type | Details |
| query | Yes | string | A URI reference to a user format: |
| Local | No | string | Named private credential label |
list_user_busy_times
calendly-cli list-user-busy-times · GET /user_busy_times
Argument | Route | Required | Type | Details |
| query | Yes | string | The uri associated with the user format: |
| query | Yes | string | Start time of the requested availability range. Date cannot be in the past. |
| query | Yes | string | End time of the requested availability range. Date must be in the future of start_time. |
| Local | No | string | Named private credential label |
create_contact
calendly-cli create-contact · POST /contacts
Argument | Route | Required | Type | Details |
| Body | Yes in body | string | Current schema |
| Body | Yes in body | array | The user's email addresses. Max 10. minItems: |
| Nested body | Yes in body | string | Email address. format: |
| Nested body | Yes in body | boolean | Whether this is the primary email. |
| Body | No | array | The user's phone numbers. Max 10. maxItems: |
| Nested body | Yes in body | string | Phone number. |
| Body | No | string | Current schema |
| Body | No | string | Current schema |
| Body | No | string | Current schema |
| Body | No | string | Current schema |
| Body | No | string | Current schema |
| Body | No | string | Current schema |
| Body | No | string | format: |
| Body | No | array | Custom field values to set on the contact. Each item requires a |
| Nested body | Yes in body | string | Unique identifier of the custom field definition. |
| Nested body | Yes in body | JSON union | The custom field value; the accepted type is set by the field definition's |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
list_contacts
calendly-cli list-contacts · GET /contacts
Argument | Route | Required | Type | Details |
| query | No | string | Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values. Supported fields are: created_at, updated_at. Sort direction is specified as: asc, desc. |
| query | No | string | Filter results by exact match on email address. Accepts a comma-separated list. |
| query | No | string | Filter results by exact match on phone number. Accepts a comma-separated list. |
| query | No | string | Filter results by exact match on the IANA time zone name(s). Accepts a comma-separated list of time zones. |
| query | No | string | Filter results by partial match on name(s). Accepts a comma-separated list-- each segment is matched independently (commas in the query string separate values). |
| query | No | string | Filter results by partial match on job title(s). Accepts a comma-separated list-- each segment is matched independently (commas in the query string separate values). |
| query | No | string | Filter results by partial match on company name(s). Accepts a comma-separated list-- each segment is matched independently (commas in the query string separate values). |
| query | No | string | Filter results by exact match on two-letter country code (ISO 3166-1 alpha-2). Accepts a comma-separated list. |
| query | No | string | Filter results by exact match on state(s), province(s), or region(s). Accepts a comma-separated list of values. |
| query | No | string | Filter results by partial match on city(ies). Accepts a comma-separated list-- each segment is matched independently (commas in the query string separate values). |
| query | No | integer | The number of rows to return minimum: |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | string | Omit the listed fields from the response. Currently only |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
delete_contact
calendly-cli delete-contact · DELETE /contacts/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
get_contact
calendly-cli get-contact · GET /contacts/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| query | No | string | Omit the listed fields from the response. Currently only |
| Local | No | string | Named private credential label |
update_contact
calendly-cli update-contact · PATCH /contacts/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Body | No | string | Current schema |
| Body | No | array | The user's email addresses. Max 10. Warning: Updating emails will overwrite all existing emails for the contact. Use the GET endpoint to first retrieve the existing emails and then pass the modified emails to the emails array. minItems: |
| Nested body | Yes in body | string | Email address. format: |
| Nested body | Yes in body | boolean | Whether this is the primary email. |
| Body | No | array | The user's phone numbers. Max 10. Warning: Updating phone_numbers will overwrite all existing phone numbers for the contact. Use the GET endpoint to first retrieve the existing phone numbers and then pass the modified phone_numbers to the phone_numbers array. maxItems: |
| Nested body | Yes in body | string | Phone number. |
| Body | No | string | Current schema |
| Body | No | string | Current schema |
| Body | No | string | Current schema |
| Body | No | string | Current schema |
| Body | No | string | Current schema |
| Body | No | string | Current schema |
| Body | No | string | format: |
| Body | No | array | Custom field values to set on the contact. Each item requires a |
| Nested body | Yes in body | string | Unique identifier of the custom field definition. |
| Nested body | Yes in body | JSON union | The custom field value; the accepted type is set by the field definition's |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
get_contact_custom_field_definition
calendly-cli get-contact-custom-field-definition · GET /contacts/custom_field_definitions/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
list_contact_custom_field_definitions
calendly-cli list-contact-custom-field-definitions · GET /contacts/custom_field_definitions
Argument | Route | Required | Type | Details |
| Local | No | string | Named private credential label |
delete_invitee_data
calendly-cli delete-invitee-data · POST /data_compliance/deletion/invitees
Argument | Route | Required | Type | Details |
| Body | Yes in body | array | Array items: string. |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
delete_scheduled_event_data
calendly-cli delete-scheduled-event-data · POST /data_compliance/deletion/events
Argument | Route | Required | Type | Details |
| Body | Yes in body | string | The scheduled events UTC timestamp at which data deletion should begin. format: |
| Body | Yes in body | string | The scheduled events UTC timestamp at which data deletion should end. format: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
create_event_type
calendly-cli create-event-type · POST /event_types
Argument | Route | Required | Type | Details |
| Body | No | boolean | Indicates if the event type is active or not default: |
| Body | Yes in body | string | The owner for this event type format: |
| Body | Yes in body | string | The event type name |
| Body | No | string | The event type description |
| Body | No | integer | The length of sessions booked with this event type. Must be one of the duration options if they're provided. minimum: |
| Body | No | array | A maximum of 4 unique options is allowed. Each option must be >= 1 and <= 720. Array items: integer. |
| Body | No | array | Configuration information for each possible location for this event type Array items: object. |
| Nested body | No | string | Values: |
| Nested body | No | string | Current schema |
| Nested body | No | string | Current schema |
| Nested body | No | string | Current schema |
| Body | No | string | The hexadecimal color value of the event type's scheduling page pattern: |
| Body | No | string | The locale on the event type, used to determine the language of the event type's scheduling page Values: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
list_event_types
calendly-cli list-event-types · GET /event_types
Argument | Route | Required | Type | Details |
| query | No | boolean | Return only active event types if true, only inactive if false, or all event types if this parameter is omitted. |
| query | No | string | View available personal, team, and organization event types associated with the organization's URI. format: |
| query | No | string | View available personal, team, and organization event types associated with the user's URI. format: |
| query | No | string | Used in conjunction with |
| query | No | string | Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values.Supported fields are: name, position, created_at, updated_at. Sort direction is specified as: asc, desc. default: |
| query | No | boolean | Return only admin managed event types if true, exclude admin managed event types if false, or include all event types if this parameter is omitted. |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | integer | The number of rows to return minimum: |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
create_one_off_event_type
calendly-cli create-one-off-event-type · POST /one_off_event_types
Argument | Route | Required | Type | Details |
| Body | Yes in body | string | Event type name maxLength: |
| Body | Yes in body | string | Host user uri format: |
| Body | No | array | Collection of meeting co-host(s) user URIs Array items: string. |
| Body | Yes in body | number | Duration of meeting in minutes maximum: |
| Body | No | string | Time zone used for meeting. Defaults to host's time zone. |
| Body | Yes in body | JSON union | Exactly one of 3 schema branches; inspect schema for nested requirements. |
| Body | No | JSON union | Exactly one of 10 schema branches; inspect schema for nested requirements. |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
get_event_type
calendly-cli get-event-type · GET /event_types/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
update_event_type
calendly-cli update-event-type · PATCH /event_types/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Body | No | boolean | Indicates if the event type is active or not |
| Body | No | string | The event type name |
| Body | No | string | The hexadecimal color value of the event type's scheduling page pattern: |
| Body | No | string | The event type description |
| Body | No | integer | The length of sessions booked with this event type. Must be one of the duration options if they're provided. minimum: |
| Body | No | array | A maximum of 4 unique options is allowed. Each option must be >= 1 and <= 720. Array items: integer. |
| Body | No | string | The locale on the event type, used to determine the language of the event type's scheduling page Values: |
| Body | No | array | Configuration information for each possible location for this Event Type Array items: object. |
| Nested body | No | string | Values: |
| Nested body | No | string | Current schema |
| Nested body | No | string | Current schema |
| Nested body | No | string | Current schema |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
list_event_type_available_times
calendly-cli list-event-type-available-times · GET /event_type_available_times
Argument | Route | Required | Type | Details |
| query | Yes | string | The uri associated with the event type format: |
| query | Yes | string | Start time of the requested availability range. Date cannot be in the past. format: |
| query | Yes | string | End time of the requested availability range. Date must be in the future and no greater than 31 days from start_time. format: |
| Local | No | string | Named private credential label |
list_event_type_hosts
calendly-cli list-event-type-hosts · GET /event_type_memberships
Argument | Route | Required | Type | Details |
| query | Yes | string | The uri associated with the event type format: |
| query | No | integer | The number of rows to return minimum: |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
get_group
calendly-cli get-group · GET /groups/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | Group unique identifier minLength: |
| Local | No | string | Named private credential label |
get_group_relationship
calendly-cli get-group-relationship · GET /group_relationships/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
list_group_relationships
calendly-cli list-group-relationships · GET /group_relationships
Argument | Route | Required | Type | Details |
| query | No | integer | The number of rows to return minimum: |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | string | Indicates the results should be filtered by organization format: |
| query | No | string | Indicates the results should be filtered by owner One Of: - Organization Membership URI - |
| query | No | string | Indicates the results should be filtered by group format: |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
list_groups
calendly-cli list-groups · GET /groups
Argument | Route | Required | Type | Details |
| query | Yes | string | Return groups that are associated with the organization associated with this URI format: |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | integer | The number of rows to return minimum: |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
list_user_locations
calendly-cli list-user-locations · GET /locations
Argument | Route | Required | Type | Details |
| query | Yes | string | The URI associated with the user format: |
| Local | No | string | Named private credential label |
delete_recap
calendly-cli delete-recap · DELETE /meeting_recaps/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
get_recap
calendly-cli get-recap · GET /meeting_recaps/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
update_recap
calendly-cli update-recap · PATCH /meeting_recaps/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Body | No | string/null | Summary in Markdown. |
| Body | No | string/null | Action items in Markdown. |
| Body | No | string/null | Discussion notes in Markdown. |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
get_transcript
calendly-cli get-transcript · GET /meeting_recaps/{uuid}/transcript
Argument | Route | Required | Type | Details |
| path | Yes | string | The meeting recap uuid minLength: |
| Local | No | string | Named private credential label |
list_recaps
calendly-cli list-recaps · GET /meeting_recaps
Argument | Route | Required | Type | Details |
| query | No | string | Filter results to recaps associated with a specific event scheduled via Calendly. This field corresponds to the |
| query | No | string | Return recaps for meetings that end after (or end at) this time (ISO 8601). format: |
| query | No | string | Return recaps for meetings that start before (or start at) this time (ISO 8601). format: |
| query | No | string | Filter by recap availability. When omitted, returns Available recaps only. - |
| query | No | string | Filter results to recaps that include a specific attendee email address. format: |
| query | No | integer | The number of rows to return minimum: |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
get_organization
calendly-cli get-organization · GET /organizations/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | The organization's unique identifier minLength: |
| Local | No | string | Named private credential label |
get_organization_invitation
calendly-cli get-organization-invitation · GET /organizations/{org_uuid}/invitations/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | The organization’s unique identifier minLength: |
| path | Yes | string | The organization invitation's unique identifier minLength: |
| Local | No | string | Named private credential label |
revoke_organization_invitation
calendly-cli revoke-organization-invitation · DELETE /organizations/{org_uuid}/invitations/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | The organization’s unique identifier minLength: |
| path | Yes | string | The organization invitation's unique identifier minLength: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
get_organization_membership
calendly-cli get-organization-membership · GET /organization_memberships/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | The organization membership's unique identifier minLength: |
| Local | No | string | Named private credential label |
remove_from_organization
calendly-cli remove-from-organization · DELETE /organization_memberships/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | The organization membership's unique identifier minLength: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
get_team
calendly-cli get-team · GET /teams/{team_uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | Team UUID minLength: |
| Local | No | string | Named private credential label |
invite_to_organization
calendly-cli invite-to-organization · POST /organizations/{uuid}/invitations
Argument | Route | Required | Type | Details |
| path | Yes | string | The organization's unique identifier minLength: |
| Body | Yes in body | string | The email of the user being invited |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
list_organization_invitations
calendly-cli list-organization-invitations · GET /organizations/{uuid}/invitations
Argument | Route | Required | Type | Details |
| path | Yes | string | The organization's unique identifier minLength: |
| query | No | integer | The number of rows to return minimum: |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | string | Order results by the field name and direction specified (ascending or descending). Returns multiple sets of results in a comma-separated list. default: |
| query | No | string | Indicates if the results should be filtered by email address format: |
| query | No | string | Indicates if the results should be filtered by status ("pending", "accepted", or "declined") Values: |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
list_organization_memberships
calendly-cli list-organization-memberships · GET /organization_memberships
Argument | Route | Required | Type | Details |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | integer | The number of rows to return minimum: |
| query | No | string | Indicates if the results should be filtered by email address format: |
| query | No | string | Indicates if the results should be filtered by organization format: |
| query | No | string | Indicates if the results should be filtered by user format: |
| query | No | string | Indicates if the results should be filtered by role Values: |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
list_teams
calendly-cli list-teams · GET /teams
Argument | Route | Required | Type | Details |
| query | No | string | Filter results to Teams associated with a specific user format: |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | integer | The number of rows to return minimum: |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
list_outgoing_communications
calendly-cli list-outgoing-communications · GET /outgoing_communications
Argument | Route | Required | Type | Details |
| query | Yes | string | Return outgoing communications from the organization associated with this URI format: |
| query | No | integer | The number of records to return minimum: |
| query | No | string | Include outgoing communications that were created after this time (sample time format: "2020-01-02T03:04:05.678Z"). This time should use the UTC timezone format: |
| query | No | string | Include outgoing communications that were created prior to this time (sample time format: "2020-01-02T03:04:05.678Z"). This time should use the UTC timezone format: |
| query | No | string | The token to pass to get the next portion of the collection |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
get_routing_form
calendly-cli get-routing-form · GET /routing_forms/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
get_routing_form_submission
calendly-cli get-routing-form-submission · GET /routing_form_submissions/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
list_routing_form_submissions
calendly-cli list-routing-form-submissions · GET /routing_form_submissions
Argument | Route | Required | Type | Details |
| query | Yes | string | View routing form submissions associated with the routing form's URI. format: |
| query | No | integer | The number of rows to return minimum: |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | string | Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values. Supported fields are: created_at. Sort direction is specified as: asc, desc. |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
list_routing_forms
calendly-cli list-routing-forms · GET /routing_forms
Argument | Route | Required | Type | Details |
| query | Yes | string | View organization routing forms associated with the organization's URI. format: |
| query | No | integer | The number of rows to return minimum: |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | string | Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values. Supported fields are: created_at. Sort direction is specified as: asc, desc. |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
cancel_event
calendly-cli cancel-event · POST /scheduled_events/{uuid}/cancellation
Argument | Route | Required | Type | Details |
| path | Yes | string | The event's unique indentifier minLength: |
| Body | No | string | Reason for cancellation maxLength: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
create_invitee
calendly-cli create-invitee · POST /invitees
Argument | Route | Required | Type | Details |
| Body | Yes in body | string | Canonical reference (unique identifier) for the event type being scheduled format: |
| Body | Yes in body | string | The start time in UTC of the scheduled event format: |
| Body | Yes in body | object | Object requires: |
| Nested body | No | string | The full name of the invitee. Required if |
| Nested body | No | string | The first name of the invitee. Required if |
| Nested body | No | string | The last name of the invitee |
| Nested body | Yes in body | string | The email of the invitee format: |
| Nested body | Yes in body | string | The timezone of the invitee minLength: |
| Nested body | No | string | Invitee's phone number for SMS reminders. Must be a valid phone number (e.g. +14155551234) |
| Body | No | JSON union | The polymorphic base type for an event location that Calendly supports. Note: - Location.kind must be supplied if location is defined. - Location must match location specified on the EventType. - Do not pass the location object for an EventType with a round_robin pooling_type. Exactly one of 10 schema branches; inspect schema for nested requirements. |
| Body | No | array | Array items: object. |
| Nested body | Yes in body | string | A question for the invitee. String is case sensitive and must exactly match the question. |
| Nested body | Yes in body | string | The invitee's response to the question |
| Nested body | Yes in body | integer | The position of the question in relation to others |
| Body | No | object | The UTM and Salesforce tracking parameters associated with an Invitee Object requires: |
| Nested body | Yes in body | string/null | The UTM parameter used to track a campaign |
| Nested body | Yes in body | string/null | The UTM parameter that identifies the source (platform where the traffic originates) |
| Nested body | Yes in body | string/null | The UTM parameter that identifies the type of input (e.g. Cost Per Click (CPC), social media, affiliate or QR code) |
| Nested body | Yes in body | string/null | UTM content tracking parameter |
| Nested body | Yes in body | string/null | The UTM parameter used to track keywords |
| Nested body | Yes in body | string/null | The Salesforce record unique identifier |
| Body | No | array | Emails of invitee guests. Max 10. maxItems: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
create_no_show
calendly-cli create-no-show · POST /invitee_no_shows
Argument | Route | Required | Type | Details |
| Body | Yes in body | string | format: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
delete_no_show
calendly-cli delete-no-show · DELETE /invitee_no_shows/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
get_no_show
calendly-cli get-no-show · GET /invitee_no_shows/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
get_event
calendly-cli get-event · GET /scheduled_events/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | The event's unique identifier minLength: |
| Local | No | string | Named private credential label |
get_event_invitee
calendly-cli get-event-invitee · GET /scheduled_events/{event_uuid}/invitees/{invitee_uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | The event's unique identifier minLength: |
| path | Yes | string | The invitee's unique identifier minLength: |
| Local | No | string | Named private credential label |
list_event_invitees
calendly-cli list-event-invitees · GET /scheduled_events/{uuid}/invitees
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| query | No | string | Indicates if the invitee "canceled" or still "active" Values: |
| query | No | string | Order results by the created_at field and direction specified: ascending ("asc") or descending ("desc") default: |
| query | No | string | Indicates if the results should be filtered by email address format: |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | integer | The number of rows to return minimum: |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
list_events
calendly-cli list-events · GET /scheduled_events
Argument | Route | Required | Type | Details |
| query | No | string | Return events that are scheduled with the user associated with this URI format: |
| query | No | string | Return events that are scheduled with the organization associated with this URI format: |
| query | No | string | Return events that are scheduled with the invitee associated with this email address format: |
| query | No | string | Whether the scheduled event is |
| query | No | string | Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values. Supported fields are: start_time. Sort direction is specified as: asc, desc. |
| query | No | string | Include events with start times after this time (sample time format: "2020-01-02T03:04:05.678123Z"). This time should use the UTC timezone. format: |
| query | No | string | Include events with start times prior to this time (sample time format: "2020-01-02T03:04:05.678123Z"). This time should use the UTC timezone. format: |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | integer | The number of rows to return minimum: |
| query | No | string | Return events that are scheduled with the group associated with this URI format: |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
create_scheduling_link
calendly-cli create-scheduling-link · POST /scheduling_links
Argument | Route | Required | Type | Details |
| Body | Yes in body | string | The max number of events that can be scheduled using this scheduling link. Values: |
| Body | Yes in body | string | A link to the resource that owns this Scheduling Link (currently, this is always an Event Type) format: |
| Body | Yes in body | string | Resource type (currently, this is always EventType) Values: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
create_share
calendly-cli create-share · POST /shares
Argument | Route | Required | Type | Details |
| Body | Yes in body | string | format: |
| Body | No | string | maxLength: |
| Body | No | integer | Must be one of the provided duration options. If duration options aren't provided then duration must be one of the duration options inherited from the event type. minimum: |
| Body | No | array | A maximum of 4 unique options is allowed. Each option must be >= 1 and <= 720. Array items: integer. |
| Body | No | string | Values: |
| Body | No | string | is required when |
| Body | No | string | is required when |
| Body | No | integer | is required when |
| Body | No | boolean | determines if a location is hidden until invitee books a spot, only respected when there is a single custom location configured |
| Body | No | array | Array items: object. |
| Nested body | No | string | is only supported when |
| Nested body | No | string | is only supported when |
| Nested body | No | string | is required when |
| Nested body | No | integer | Current schema |
| Nested body | No | string | Values: |
| Body | No | object | Current schema |
| Nested body | No | array | are required when an availability rule is provided Array items: object. |
| Nested body | No | string | Values: |
| Nested body | No | string | is required when |
| Nested body | No | string | is required when |
| Nested body | No | array | Array items: object. |
| Nested body | No | string | Format: |
| Nested body | No | string | Format: |
| Nested body | No | string | is required when an availability rule is provided |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
get_current_user
calendly-cli get-current-user · GET /users/me
Argument | Route | Required | Type | Details |
| Local | No | string | Named private credential label |
get_user
calendly-cli get-user · GET /users/{uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | User unique identifier, or the constant "me" to reference the caller minLength: |
| Local | No | string | Named private credential label |
create_webhook
calendly-cli create-webhook · POST /webhook_subscriptions
Argument | Route | Required | Type | Details |
| Body | Yes in body | string | The URL where you want to receive POST requests for events you are subscribed to. format: |
| Body | Yes in body | array | List of user events to subscribe to. minItems: |
| Body | Yes in body | string | The unique reference to the organization that the webhook will be tied to. format: |
| Body | No | string | The unique reference to the user that the webhook will be tied to. format: |
| Body | No | string | The unique reference to the group that the webhook will be tied to. format: |
| Body | Yes in body | string | Indicates whether the webhook subscription scope is |
| Body | No | string | Optional secret key shared between your application and Calendly. See https://developer.calendly.com/api-docs/overview/webhooks/webhook-signatures for additional information. |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
| Complete body | Alternative | object | Complete current body JSON; no mixed body flags |
| Complete body | Alternative | string | Regular local JSON file, at most 5 MB |
list_webhooks
calendly-cli list-webhooks · GET /webhook_subscriptions
Argument | Route | Required | Type | Details |
| query | Yes | string | The given organization that owns the subscriptions being returned. This field is always required. format: |
| query | No | string | Indicates if the results should be filtered by user. This parameter is only required if the |
| query | No | string | Indicates if the results should be filtered by group. This parameter is only required if the |
| query | No | string | The token to pass to get the next or previous portion of the collection |
| query | No | integer | The number of rows to return minimum: |
| query | No | string | Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values. Supported fields are: created_at. Sort direction is specified as: asc, desc. |
| query | Yes | string | Filter the list by organization, user, or group Values: |
| Local | No | string | Named private credential label |
| Local paging | No | boolean | Bounded native page_token collection; at most 100 requests |
| Local paging | No | integer | 1 to 10000, default 1000; requires all_pages |
delete_webhook
calendly-cli delete-webhook · DELETE /webhook_subscriptions/{webhook_uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
| Guard | Yes to execute | boolean | Explicit true for this requested mutation |
get_webhook
calendly-cli get-webhook · GET /webhook_subscriptions/{webhook_uuid}
Argument | Route | Required | Type | Details |
| path | Yes | string | minLength: |
| Local | No | string | Named private credential label |
get_sample_webhook_data
calendly-cli get-sample-webhook-data · GET /sample_webhook_data
Argument | Route | Required | Type | Details |
| query | Yes | string | Values: |
| query | Yes | string | format: |
| query | No | string | format: |
| query | Yes | string | Values: |
| query | No | string | format: |
| Local | No | string | Named private credential label |
list_accounts
calendly-cli list-accounts lists private labels, defaults and credential method without tokens, file paths or account content. It accepts no arguments.
9. Scheduling, contacts and recap workflows
Find the right event type and available slot
Read get_current_user for canonical user and organization URIs. List event types for that user or organization, inspect the chosen event type and its location/host requirements, then request current slots. Event-type availability now permits at most 31 days; user busy times still permit at most seven. Both need a future increasing time range. Split larger windows deliberately; availability is not reserved by a read.
calendly-cli get-current-user --agent
calendly-cli list-event-types --user https://api.calendly.com/users/USER_UUID --count 10 --agent
calendly-cli get-event-type --event-type-uuid EVENT_TYPE_UUID --agent
calendly-cli list-event-type-available-times --event-type https://api.calendly.com/event_types/EVENT_TYPE_UUID --start-time 2030-01-02T00:00:00Z --end-time 2030-01-16T00:00:00Z --agentDates/URIs are illustrative. Replace them with a currently valid future range and actual returned resources. Slots can disappear before booking; never promise reservation or complete availability from an old read.
Book only the confirmed invitee and slot
Create a private payload file containing event_type URI, start_time in UTC, and invitee email, timezone and name or first_name. Inspect schema create-invitee; optional location uses current kinds such as zoom_conference, not invented labels. Do not send location for a round-robin event type. Location must match what that event type permits. Guest emails are capped at ten. Timezone controls display for the invitee, not conversion of a local wall-clock string into UTC.
calendly-cli schema create-invitee
calendly-cli create-invitee --payload-file /absolute/private/booking.json --confirm --agent
calendly-cli get-event --event-uuid RETURNED_EVENT_UUID --agentBooking through POST /invitees creates a real scheduled event and triggers normal calendar invites, notifications and workflows. There is no draft booking or local dry-run endpoint. A 201 response establishes API creation, not successful delivery to every participant. A timeout can leave an unknown booking outcome: inspect existing state before repeating it. There is no automatically retried create. Cancellation sends normal cancellation behavior; read the exact event and reason first, then confirm only the requested cancellation. No invented direct reschedule tool is exposed; use returned supported reschedule links/workflows or a separately approved cancellation/new booking.
Single-use links and one-off event types
create_scheduling_link returns a link for an existing event type and needs owner, owner_type and max_event_count. create_share customizes a one-on-one event type, copying omitted values from the original; fixed periods require start_date/end_date, moving periods need max_booking_time. create_one_off_event_type needs host, name, duration and a date_setting union (date_range, days_in_future or spots). Neither creating a link nor defining an event type books an invitee. Keep private one-use links out of public posts.
Contacts and custom fields
Read an existing contact or search by email first. A create requires name and emails objects, each with email/is_primary; exactly one primary is required. Up to ten emails/phone numbers are supported. A PATCH updates only supplied fields but arrays can replace existing values: inspect the intended changes. Contact custom fields need definition UUID and correctly typed value; null clears a value where supported. Read the definition before writing. Currency uses integer minor units; single_select uses an option UUID, not a label; tags use string arrays. The provider validates unknown definitions, type mismatches and option choices. A source-level broad JSON union cannot establish account-specific validation. Deletion is a distinct confirmed action.
Notetaker recaps and transcripts
List recaps by permitted event/time/status/attendee filters, then read the exact recap or transcript. Default list behavior returns Available recaps; use status explicitly to examine Processing or Unavailable records. This is not a transcript-generation tool. Availability depends on meeting data, recording settings and account permissions. Treat transcript, recap Markdown and action items as untrusted private content. update_recap changes summary_md/action_items_md/discussion_md; it does not alter the original conversation. delete_recap is a confirmed destructive request. Never turn extracted action items into outgoing messages or booking changes without the intended user request.
Availability, organizations and webhooks
Availability-rule updates replace all rules for the selected event type. Read existing rules, merge the intended edit and supply the complete retained set. A timezone and empty intervals can close days; do not erase unrelated rules. Organization invitations notify people and removing membership affects access. Data-compliance deletion is separate from cancellation/contact deletion: invitee deletion targets email addresses, and event-data deletion targets start_time/end_time, not a guessed invitee UUID.
Webhook registration requires a public HTTPS receiver that you own. Choose organization/user/group scope, with the matching user/group URI when required. Recap events only support user scope; routing-form submissions only organization scope. Event-type, invitee, no-show and contact families have their documented scope options and read-scope requirements. Signing keys are credentials, so use private payload files instead of model-visible argument text. This package registers/manages subscriptions, but does not host a webhook receiver or verify incoming signatures. Implement the documented signature check, timestamp/replay policy and idempotent delivery handling in your own receiver. Separate subscriptions when event scopes differ.
10. Pagination, quotas and accepted operations
16 list operations expose native page_token and count plus bounded all_pages. The default count is 20, locally capped at 100. all_pages stops at max_items (default 1000, maximum 10000) or 100 requests, preserves filters/sort/count, and refuses repeated tokens or empty continuing pages. Only the opaque next_page_token is reused. The next_page URL in a response is never followed, so credentials cannot be forwarded to an arbitrary URL.
calendly-cli list-contacts --count 25 --agent
calendly-cli list-contacts --count 25 --all-pages --max-items 500 --agentAggregated results retain collection/pagination and add collected/pages/truncated/resume. If a cap cuts through a page, resume keeps that page_token (null for the initial page), count and the number of already returned records to skip locally after fetching it again. After a full page, resume points at the next token with skip 0. Preserve the exact filters/sort/count and do not invent a skip API flag. Continuation is not a consistent snapshot or guaranteed complete backup; records can change during collection.
Every page/retried read consumes the user's shared provider quota. Booking has tighter daily/hourly limits than generic reads. A long reset delay becomes exit 7 rather than an early retry. POST/DELETE/PATCH have zero automatic retries. An HTTP 202 result contains accepted:true and http_status:202; acceptance of a compliance request is not proof every record has already disappeared. Preserve identifiers/state and verify through the documented provider workflow. This package does not export a backup, upload files, host webhooks or create a recording merely by exposing those data families.
11. Several private accounts
Use private CALENDLY_ACCOUNTS JSON instead of the single-account settings:
[{"name":"work","token_file":"/absolute/private/work-token.txt"},{"name":"personal","tokens_file":"/absolute/private/personal-oauth.json"}]Each label has exactly one PAT or OAuth method. Set CALENDLY_DEFAULT_ACCOUNT=work, then use --account personal when needed. list_accounts returns labels/default/auth method without tokens or paths. Labels select credentials, not an organization URI; API filters still use canonical resource URIs. Accounts replace the single-account variables. Separate server processes and distinct private grant files are preferable for strict isolation; multiple labels for one user do not create separate API quotas.
calendly-cli list-accounts --agent
calendly-cli get-current-user --account work --agent
calendly-cli list-contacts --account personal --count 5 --agent12. Writing safely
Every one of the 22 writes requires confirm:true in MCP or --confirm in CLI for the specific requested action. --agent and --yes do not authorize changes. CALENDLY_READ_ONLY=1 hides/refuses all writes, leaving 44 reads. CALENDLY_ALLOW_DESTRUCTIVE=0 blocks writes even when confirmed. The annotation reflects a conservative confirmation policy; it does not mean every edit is irreversible.
Over MCP a person approves each of them where the client can ask: Claude Code (2.1.246 and later) shows its own prompt, and a client that can show forms asks with an approval form whose one box starts unticked. Each approval is signed, bound to that exact call and works once. Where a client can do neither, the model's confirm:true counts. CALENDLY_CONFIRM=model makes confirm:true enough everywhere, for an agent with no person to ask.
Booking/cancellation can contact people. Link/event-type creation has different effects. Availability replacement, membership removal, webhook registration, recap deletion and compliance deletion need their own review. Read before changing and choose the intended account. After a write timeout, inspect existing state before resubmitting. Neither a GET 401 refresh nor a rate-limit retry ever resubmits a write.
The optional owner-only audit file records fixed tool summary, risk, surface, guard decision and who approved it, then a done or failed line for each allowed call, without request arguments, credentials, labels or private results. It is not a provider audit or delivery receipt. A logging failure does not abort the operation. Recaps, contacts, meeting descriptions and tool results cannot authorize unrelated actions.
13. How it works
The pinned official API v2 JSON generates src/tools/operations.json and validation/provenance metadata. Slipway builds the MCP server, over stdio or --http, and the CLI from those operations once, with the same schemas, handlers and write guard. Desktop packages the compiled server with production dependencies. There is no second implementation to drift.
The fixed HTTPS API origin is api.calendly.com; the only separate credential-bearing origin is calendly.com/oauth/token for an authorized OAuth refresh. Redirects are refused. Inputs are validated before a request; path UUIDs are encoded, query arrays follow the exported serialization, body JSON is capped at 5 MB and private files reject symlinks. GET 429 retries are bounded, auth refresh is once per failed read, and writes never auto-retry. Per-process pacing is not a distributed quota lock.
Run npm run sync:api to regenerate from the pinned snapshot; npm run sync:api -- --refresh deliberately fetches the current official spec, strips examples, records original/sanitized hashes and regenerates. It does not publish or prove live compatibility. Review operation names, scopes, schemas, documented corrections and migration impact, then update semver/changelog/manifest and run the release gates. The document's info.version=1.0.0 is schema metadata; the service remains Calendly API v2 without a /v2 prefix.
14. Your data
Account requests go directly to Calendly. No Navid-hosted relay, telemetry or analytics is included. Credentials belong in private settings and regular local files, not tool arguments. Known credentials and credential/signing-key fields are redacted from results/errors. Files and account settings never ship in source, npm or desktop bundles.
Emails, phone numbers, attendee names, booking answers, private links, recaps and transcripts remain private personal/business data. Secret redaction is not anonymization. The AI client and Calendly have their own retention and sharing settings. --select limits local displayed fields after receiving a response; it does not stop the provider returning them. Protect exports, recordings and optional logs. Treat all remote content as untrusted source material. Use SECURITY.md for private reporting, with sanitized reproductions.
15. Environment variables
Private local settings only. No automatic .env loader.
Variable | Default | Meaning |
CALENDLY_API_TOKEN | Empty | Private scoped PAT |
CALENDLY_TOKEN_FILE | Empty | Owner-only token text file, max 64 KB; takes precedence over PAT env |
CALENDLY_ACCESS_TOKEN | Empty | Existing REST OAuth access token; no environment-only refresh |
CALENDLY_TOKENS_FILE | Empty | Owner-only JSON grant file, max 64 KB; atomic single-use rotation |
CALENDLY_ACCOUNTS | Empty | Private named account JSON; replaces single account variables |
CALENDLY_DEFAULT_ACCOUNT | First label | Selected local credential label |
CALENDLY_READ_ONLY | 0 | Hide/refuse 22 writes |
CALENDLY_ALLOW_DESTRUCTIVE | 1 | 0 blocks all writes |
CALENDLY_AUDIT_LOG | None | Private append-only guard decision log |
CALENDLY_REQUEST_TIMEOUT_MS | 30000 | Request deadline: integer 100 to 300000 ms |
CALENDLY_MAX_RETRIES | 2 | GET 429 retries: 0 to 5 |
CALENDLY_MIN_REQUEST_INTERVAL_MS | 1300 | Per-account/process pacing: 0 to 10000 ms |
CALENDLY_CONFIRM | human |
|
CALENDLY_SURFACE | full |
|
CALENDLY_TOOL_TIMEOUT_MS | None | Give up on any tool after this long |
CALENDLY_HTTP_PORT, CALENDLY_HTTP_HOST, CALENDLY_HTTP_TOKEN | 8787, 127.0.0.1, none | For |
CALENDLY_HTTP_ALLOWED_ORIGINS | None | Comma-separated browser origins allowed to call |
CALENDLY_DEBUG | 0 | 1 prints debug lines on stderr |
16. Updates and removal
npm install -g @thenavidm/calendly-mcp-cli@latest
calendly-cli --version
claude mcp remove --scope user calendly
codex mcp remove calendly
npm uninstall -g @thenavidm/calendly-mcp-cliRestart @latest MCP entries to resolve the new version; a running process does not update itself. Pin a reviewed version for reproducible automation. Read CHANGELOG.md and GitHub Releases before major updates. Manually installed desktop extensions need the new versioned .mcpb installed separately. No directory-driven automatic desktop update is claimed.
Remove each manual client entry and copied skill as appropriate. Uninstalling does not revoke tokens, undo bookings, revoke OAuth grants, remove account data or reverse invitations. Revoke tokens in Calendly separately. Preserve private data before removing local private files. Do not overwrite an existing npm version to roll back.
17. Troubleshooting
Symptom | Check |
Missing command | Node 22+, global npm prefix/PATH, new terminal; Windows npm.cmd if policy blocks npm.ps1 |
No credentials | Private selected account, correct PAT/OAuth method, regular owner-only files |
GUI auth failure | GUI private environment is separate from shell exports |
401 | Revoked/expired grant, correct token, OAuth expiry metadata and reauthorization |
403 | Endpoint scope, role and paid/Teams/Enterprise feature requirement; regrant changed scopes |
OAuth refresh locked | Another process may be rotating; wait, never remove an active lock |
Invalid/unknown refresh | Reauthorize and repair storage, restart; do not reuse consumed tokens |
Slot rejected | Future UTC range, 31-day slot limit or 7-day busy-time limit; slot may have changed |
Booking validation | Name or first_name, email, timezone, allowed location kind; omit location for round-robin |
Webhook rejected | HTTPS receiver, scope/user/group URI and each event family's auth scope |
First page only | Use supported page_token/count or bounded all_pages with resume state |
Contact custom field rejected | Actual definition UUID, type and allowed option UUID; null where supported |
Recap unavailable | Current status, meeting data, Notetaker access and recording permissions |
Write timeout | Inspect account state before repeating; no automatic retries |
Guard refusal | Intended --confirm, read-only/destructive settings; --yes is not consent |
Desktop extension rejected | Host/runtime and organization custom-extension policy |
Include version/client/OS and sanitized error shape in issues. Never include real tokens, private participants, transcript excerpts or webhook signing keys.
18. API coverage and comparisons
Offering | Surface | Documented scope and tradeoff |
Hosted https://mcp.calendly.com, DCR OAuth/PKCE | Strong scheduling and user/organization coverage plus provider skills; no PAT/static console OAuth connection | |
This package | Local MCP + shared CLI + desktop archive | 65 current REST operations plus local helper; Contacts/custom fields/Notetaker, private PAT/REST OAuth, named accounts, bounded cursors and explicit guards; local maintenance required |
Documentation search/reference; not authenticated account scheduling | ||
Community CLI + MCP | Documents PAT login, user/organization auto-resolution, agent JSON and scheduling commands; its current README still states a seven-day event-slot range, versus the official July 2026 change to 31 | |
Community MCP | Documents PAT/OAuth and end-to-end booking, discovery, availability and locations; review its current implementation/permissions before use |
Checked October 2, 2026. The official supported-tools table lists 34 account operations plus two skills, but this is a documentation count, not authenticated tools/list. It does not list Contacts/Notetaker in the reviewed table. It shows several paths that differ from the current REST spec (availability schedules, locations, share and routing submissions). Our API routes use the current OpenAPI; that discrepancy does not prove the official hosted MCP fails. Neither tool counts nor schema size establish task success or token savings.
No dedicated Calendly-published task CLI was identified in the reviewed official developer pages. A community CLI does exist, so we do not claim the CLI category is empty. Community scope observations are documentation/source reviews, not competitor handshakes or live booking tests. See COMPARISON.md for evidence scope and the pending matched task comparison.
Current primary sources: API reference, OpenAPI, scopes, quota, release notes and MCP tools. Original/sanitized hashes and reviewed schema corrections are in src/tools/api-source.json.
19. Versions
Component | Current baseline | Meaning |
Package / desktop manifest | 3.0.1 | Shared MCP/CLI, current API and guarded workflows |
Calendly service | API v2 | Fixed api.calendly.com, no /v2 URL prefix |
OpenAPI info.version | 1.0.0 | Document metadata, not service version |
Slipway | 0.1.17 | The MCP server and the CLI from one definition of each tool |
MCP TypeScript SDK, through Slipway | 2.3.0 | The protocol and its transports |
Node | 22+ | CLI/manual MCP and compatible desktop runtime |
Legacy source | 1.0.0 / 38 declared tools | Manually assembled MCP-only implementation |
Many old tool names remain, but use current schema arguments and routes. Path identifiers use meaningful *_uuid flags; filters use canonical full URIs. Availability updates use PATCH /event_type_availability_schedules with event_type query URI; user locations use /locations, customized links /shares, and form submissions the global resource with form filter. New Contacts/Notetaker families and current webhook scope/event rules are included. API v1 ended March 31, 2025. The July 2026 event-slot limit is 31 days; the user busy-time limit stays seven. OAuth refresh tokens have rotated once since the August 2026 deadline.
See CHANGELOG.md for exact legacy-name migration and current corrections. Preserve AGPL-3.0-or-later. Build/typecheck, 36 tests and actual discovery are distinct from live account outcomes and GUI installation, which remain unverified; section 7 has the measured token costs.
20. FAQ
A local stdio server exposing Calendly operations to an AI client through structured tool schemas.
calendly-cli runs the same operations through the actual shared MCP implementation. Shell agents and scripts can use it.
Yes, hosted at https://mcp.calendly.com, using DCR OAuth 2.1 and PKCE. It is a strong scheduling option.
Local CLI use, PAT/REST OAuth grants, named accounts, Contacts/Notetaker operations, bounded pagination and explicit guards. No overall superiority or efficiency percentage is claimed.
Yes. The reviewed bcharleson/calendly-cli repository offers a community CLI and MCP. No dedicated provider-published task CLI was identified in the official pages reviewed.
The wrapper preserves AGPL-3.0-or-later. Calendly plan charges, permissions and quotas remain separate.
In your intended Calendly account, open Integrations > API and webhooks, generate a scoped token and store it privately.
Use private local settings or owner-only files outside repositories. Never put tokens or signing keys in chats, issues or shared project configs.
No, it prints setup instructions. Bring your own authorized REST grant; the official hosted MCP separately handles DCR OAuth in a compatible client.
A private JSON token file is required. Rotation is locked, single-use and atomically saved. Failed or unknown rotations require reauthorization/repair and restart, rather than repeated token use.
The versioned .mcpb bundles production dependencies and supports private sensitive PAT/file settings. Compatible host/runtime and custom-extension policy apply; GUI installation is separately unverified.
It needs local stdio. For remote URL clients, check the official hosted MCP and DCR compatibility.
It creates a real booking with normal calendar invites, notifications and workflows. There is no draft booking; explicit confirmation is required.
No invented reschedule endpoint is exposed. Use supported returned links/workflows or a separately approved cancellation/new booking.
Event-type available slots now allow up to 31 days; user busy-time queries remain capped at seven. Both need future increasing ranges.
Supported native page_token lists have bounded all_pages, max_items and a 100-request cap. Every page uses quota, and continuation is not a snapshot.
The result cap cut through a page. Fetch the same token with identical filters/count and skip that many records locally. There is no skip API flag.
It reads existing Notetaker transcript/recap data where your account provides it. It does not record a meeting or bypass access/consent requirements.
No. Inspect state after an unknown booking or edit outcome before repeating it. GET retries and auth refresh do not resubmit writes.
It depends on the client and the task. In Claude Code the CLI costs nothing until it is used, plus about 1,400 tokens for SKILL.md once, where the server costs about 1,200 tokens a message with tool search and 40,000 with every tool loaded. In Codex, finding the command that cancels an event took a median of 83,073 input tokens over the CLI and 48,780 over MCP. Section 7 has how each was measured.
Questions
Open a sanitized issue with version/client/OS. Use SECURITY.md for private reports.
About the author
Navid Moazzez is a leading AI business strategist, and the host of the AI Creator Summit, watched by 100,000+ creators. He helps creators and founders master AI and build their own AI Operating System (AI OS) to automate their business and life. He creates useful free tools, MCP servers and CLIs that creators and founders can use in their own workflows.
Links
Personal website: navid.me
Link in bio: navid.bio
Navid Media: navid.media
YouTube: @thenavidm and @thenavidai
X: @thenavidm
Instagram: @thenavidm
LinkedIn: thenavidm
Dependencies
Dependency | Version range | Used for |
| The MCP server and the CLI from one definition of each tool, with the MCP TypeScript SDK | |
|
| JSON Schema input validation |
|
| JSON Schema input validation |
Full third-party attribution is in THIRD_PARTY_NOTICES.md. Development tooling and its audit limitations are documented in SECURITY.md.
License
AGPL-3.0-or-later, preserving the existing license. See LICENSE, full AGPL text and THIRD_PARTY_NOTICES.md. Calendly service/documentation terms remain separate.
© 2026 Navid Media. Made with ❤️ by Navid Moazzez.
Available Tools
66 toolscancel_eventCancel EventADestructive
Cancel Event. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: scheduled_events:write.
Inputs: event_uuid (required), reason, account, confirm, +2 more.
create_contactCreate ContactCDestructive
Create Contact. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: contacts:write.
Inputs: city, name, state, emails, +11 more.
create_event_typeCreate Event TypeBDestructive
Create Event Type. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: event_types:write.
Inputs: name, color, owner, active, +9 more.
create_inviteeCreate Event Invitee (Scheduling API)BDestructive
Create Event Invitee (Scheduling API). Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: scheduled_events:write.
Inputs: account, confirm, invitee, payload, +7 more.
create_no_showCreate Invitee No ShowBDestructive
Create Invitee No Show. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: scheduled_events:write.
Inputs: account, confirm, invitee, payload, +1 more.
create_one_off_event_typeCreate One-Off Event TypeBDestructive
Create One-Off Event Type. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: event_types:write.
Inputs: host, name, account, confirm, +7 more.
create_scheduling_linkCreate Single-Use Scheduling LinkADestructive
Create Single-Use Scheduling Link. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: scheduling_links:write.
Inputs: owner, account, confirm, payload, +3 more.
create_webhookCreate Webhook SubscriptionBDestructive
Create Webhook Subscription. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: scheduled_events:read, event_types:read, meeting_recaps:read, routing_forms:read, contacts:read, webhooks:write.
Inputs: url, user, group, scope, +7 more.
delete_contactDelete ContactADestructive
Delete Contact. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: contacts:write.
Inputs: contact_uuid (required), account, confirm.
delete_invitee_dataDelete Invitee DataBDestructive
Delete Invitee Data. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: data_compliance:write.
Inputs: emails, account, confirm, payload, +1 more.
delete_no_showDelete Invitee No ShowCDestructive
Delete Invitee No Show. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: scheduled_events:write.
Inputs: no_show_uuid (required), account, confirm.
delete_recapDelete RecapBDestructive
Delete Recap. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: meeting_recaps:write.
Inputs: recap_uuid (required), account, confirm.
delete_scheduled_event_dataDelete Scheduled Event DataADestructive
Delete Scheduled Event Data. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: data_compliance:write.
Inputs: account, confirm, payload, end_time, +2 more.
delete_webhookDelete Webhook SubscriptionADestructive
Delete Webhook Subscription. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: webhooks:write.
Inputs: webhook_uuid (required), account, confirm.
get_availability_scheduleGet User Availability ScheduleCRead-onlyIdempotent
Get User Availability Schedule. Reads Calendly data. Required scopes: availability:read.
Inputs: schedule_uuid (required), account.
get_contactGet ContactCRead-onlyIdempotent
Get Contact. Reads Calendly data. Required scopes: contacts:read.
Inputs: contact_uuid (required), account, exclude.
get_contact_custom_field_definitionGet Contact Custom Field DefinitionCRead-onlyIdempotent
Get Contact Custom Field Definition. Reads Calendly data. Required scopes: contacts:read.
Inputs: definition_uuid (required), account.
get_current_userGet current userBRead-onlyIdempotent
Get current user. Reads Calendly data. Required scopes: users:read.
Inputs: account.
get_eventGet EventCRead-onlyIdempotent
Get Event. Reads Calendly data. Required scopes: scheduled_events:read.
Inputs: event_uuid (required), account.
get_event_inviteeGet Event InviteeCRead-onlyIdempotent
Get Event Invitee. Reads Calendly data. Required scopes: scheduled_events:read.
Inputs: event_uuid (required), invitee_uuid (required), account.
get_event_typeGet Event TypeCRead-onlyIdempotent
Get Event Type. Reads Calendly data. Required scopes: event_types:read.
Inputs: event_type_uuid (required), account.
get_groupGet GroupCRead-onlyIdempotent
Get Group. Reads Calendly data. Required scopes: groups:read.
Inputs: group_uuid (required), account.
get_group_relationshipGet Group RelationshipCRead-onlyIdempotent
Get Group Relationship. Reads Calendly data. Required scopes: groups:read.
Inputs: relationship_uuid (required), account.
get_no_showGet Invitee No ShowCRead-onlyIdempotent
Get Invitee No Show. Reads Calendly data. Required scopes: scheduled_events:read.
Inputs: no_show_uuid (required), account.
get_organizationGet OrganizationARead-onlyIdempotent
Get Organization. Reads Calendly data. Required scopes: organizations:read.
Inputs: org_uuid (required), account.
get_organization_invitationGet Organization InvitationCRead-onlyIdempotent
Get Organization Invitation. Reads Calendly data. Required scopes: organizations:read.
Inputs: org_uuid (required), invitation_uuid (required), account.
get_organization_membershipGet Organization MembershipCRead-onlyIdempotent
Get Organization Membership. Reads Calendly data. Required scopes: organizations:read.
Inputs: membership_uuid (required), account.
get_recapGet RecapCRead-onlyIdempotent
Get Recap. Reads Calendly data. Required scopes: meeting_recaps:read.
Inputs: recap_uuid (required), account.
get_routing_formGet Routing FormCRead-onlyIdempotent
Get Routing Form. Reads Calendly data. Required scopes: routing_forms:read.
Inputs: form_uuid (required), account.
get_routing_form_submissionGet Routing Form SubmissionBRead-onlyIdempotent
Get Routing Form Submission. Reads Calendly data. Required scopes: routing_forms:read.
Inputs: submission_uuid (required), account.
get_sample_webhook_dataGet sample webhook dataCRead-onlyIdempotent
Get sample webhook data. Reads Calendly data. Required scopes: webhooks:read.
Inputs: event (required), scope (required), organization (required), user, +2 more.
get_teamGet TeamCRead-onlyIdempotent
Get Team. Reads Calendly data. Required scopes: organizations:read.
Inputs: team_uuid (required), account.
get_transcriptGet TranscriptCRead-onlyIdempotent
Get Transcript. Reads Calendly data. Required scopes: meeting_recaps:read.
Inputs: recap_uuid (required), account.
get_userGet userCRead-onlyIdempotent
Get user. Reads Calendly data. Required scopes: users:read.
Inputs: uuid (required), account.
get_webhookGet Webhook SubscriptionBRead-onlyIdempotent
Get Webhook Subscription. Reads Calendly data. Required scopes: webhooks:read.
Inputs: webhook_uuid (required), account.
invite_to_organizationInvite User to OrganizationBDestructive
Invite User to Organization. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: organizations:write.
Inputs: org_uuid (required), email, account, confirm, +2 more.
list_accountsList configured accountsARead-onlyIdempotent
List private account labels, default selection and configured token method. No credentials, token paths or Calendly content; no network request.
Inputs: no named parameters.
list_activity_logList activity log entriesBRead-onlyIdempotent
List activity log entries. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: activity_log:read.
Inputs: organization (required), sort, actor, count, +9 more.
list_availability_schedulesList User Availability SchedulesBRead-onlyIdempotent
List User Availability Schedules. Reads Calendly data. Required scopes: availability:read.
Inputs: user (required), account.
list_contact_custom_field_definitionsList Contact Custom Field DefinitionsBRead-onlyIdempotent
List Contact Custom Field Definitions. Reads Calendly data. Required scopes: contacts:read.
Inputs: account.
list_contactsList ContactsBRead-onlyIdempotent
List Contacts. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: contacts:read.
Inputs: city, name, sort, count, +12 more.
list_event_inviteesList Event InviteesBRead-onlyIdempotent
List Event Invitees. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: scheduled_events:read.
Inputs: event_uuid (required), sort, count, email, +5 more.
list_eventsList EventsCRead-onlyIdempotent
List Events. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: scheduled_events:read.
Inputs: sort, user, count, group, +9 more.
list_event_type_availability_schedulesList Event Type Availability SchedulesCRead-onlyIdempotent
List Event Type Availability Schedules. Reads Calendly data. Required scopes: availability:read.
Inputs: event_type (required), account.
list_event_type_available_timesList Event Type Available TimesCRead-onlyIdempotent
List Event Type Available Times. Reads Calendly data. Required scopes: availability:read.
Inputs: end_time (required), event_type (required), start_time (required), account.
list_event_type_hostsList Event Type HostsBRead-onlyIdempotent
List Event Type Hosts. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: event_types:read.
Inputs: event_type (required), count, account, all_pages, +2 more.
list_event_typesList User's Event TypesARead-onlyIdempotent
List User's Event Types. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: event_types:read.
Inputs: sort, user, count, active, +7 more.
list_group_relationshipsList Group RelationshipsBRead-onlyIdempotent
List Group Relationships. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: groups:read.
Inputs: count, group, owner, account, +4 more.
list_groupsList GroupsBRead-onlyIdempotent
List Groups. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: groups:read.
Inputs: organization (required), count, account, all_pages, +2 more.
list_organization_invitationsList Organization InvitationsBRead-onlyIdempotent
List Organization Invitations. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: organizations:read.
Inputs: org_uuid (required), sort, count, email, +5 more.
list_organization_membershipsList Organization MembershipsCRead-onlyIdempotent
List Organization Memberships. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: organizations:read.
Inputs: role, user, count, email, +5 more.
list_outgoing_communicationsList outgoing communicationsBRead-onlyIdempotent
List outgoing communications. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: outgoing_communications:read.
Inputs: organization (required), count, account, all_pages, +4 more.
list_recapsList RecapsBRead-onlyIdempotent
List Recaps. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: meeting_recaps:read.
Inputs: count, event, status, account, +6 more.
list_routing_formsList Routing FormsBRead-onlyIdempotent
List Routing Forms. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: routing_forms:read.
Inputs: organization (required), sort, count, account, +3 more.
list_routing_form_submissionsList Routing Form SubmissionsCRead-onlyIdempotent
List Routing Form Submissions. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: routing_forms:read.
Inputs: form (required), sort, count, account, +3 more.
list_teamsList TeamsBRead-onlyIdempotent
List Teams. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: organizations:read.
Inputs: user, count, account, all_pages, +2 more.
list_user_busy_timesList User Busy TimesCRead-onlyIdempotent
List User Busy Times. Reads Calendly data. Required scopes: availability:read.
Inputs: user (required), end_time (required), start_time (required), account.
list_user_locationsList User Meeting LocationsBRead-onlyIdempotent
List User Meeting Locations. Reads Calendly data. Required scopes: locations:read.
Inputs: user (required), account.
list_webhooksList Webhook SubscriptionsBRead-onlyIdempotent
List Webhook Subscriptions. Reads Calendly data. Supports bounded opaque page_token retrieval. Required scopes: webhooks:read.
Inputs: scope (required), organization (required), sort, user, +6 more.
remove_from_organizationRemove User from OrganizationADestructive
Remove User from Organization. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: organizations:write.
Inputs: membership_uuid (required), account, confirm.
revoke_organization_invitationRevoke User's Organization InvitationADestructive
Revoke User's Organization Invitation. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: organizations:write.
Inputs: org_uuid (required), invitation_uuid (required), account, confirm.
update_contactUpdate ContactCDestructive
Update Contact. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: contacts:write.
Inputs: contact_uuid (required), city, name, state, +12 more.
update_event_typeUpdate Event TypeBDestructive
Update Event Type. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: event_types:write.
Inputs: event_type_uuid (required), name, color, active, +9 more.
update_event_type_availability_schedulesUpdate Event Type Availability SchedulesBDestructive
Update Event Type Availability Schedules. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: availability:write.
Inputs: event_type (required), account, confirm, payload, +3 more.
update_recapUpdate RecapADestructive
Update Recap. Changes Calendly state and requires confirm=true for the specific requested action. Required scopes: meeting_recaps:write.
Inputs: recap_uuid (required), account, confirm, payload, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 66 tools
Tool names are mostly distinct, but many share similar patterns (e.g., get_group_relationship vs list_group_relationships; get_event_type vs list_event_type_availability_schedules; get_contact vs get_contact_custom_field_definition) and there are two tools named 'get_current_user' and 'get_user', 'list_events' vs 'list_activity_log' (which may overlap), and 'list_teams' vs 'list_groups' which could be confused. Descriptions help but the volume and specificity create occasional ambiguity.
Names follow a consistent verb_noun pattern with snake_case throughout (e.g., get_, list_, create_, update_, delete_). The pattern is largely predictable, with only minor deviations such as 'create_one_off_event_type' and 'invite_to_organization' that slightly break the regular noun phrase structure.
With 66 tools, the surface is very large for a single MCP server, likely overwhelming for an agent and increasing selection errors. While Calendly's API is broad, this exceeds the typical 3-15 range for well-scoped servers and would benefit from splitting by functional area or using more generic resource-oriented tools.
The set covers a wide range of Calendly domains (users, events, invitees, event types, availability, groups, organizations, routing forms, webhooks, etc.) with CRUD operations for many. However, a few gaps exist: no delete for event types (only create/update), no update for webhooks, and limited CRUD for routing forms (only read operations). These are minor gaps that agents can largely work around.
Maintenance
Related MCP Connectors
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Connect AI agents to 1000+ apps with managed authentication and tool-calling.
Verified, pay-per-use API tools for AI agents through one authenticated connection.
Calendars, tasks, contacts, bookings and agent inboxes for your assistant. EU-hosted, OAuth.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables interaction with Calendly to manage event types, scheduled events, and invitees. It provides tools for checking user availability and canceling appointments directly through the Calendly API.7MIT
- AlicenseNot gradedqualityDmaintenanceExposes Cal.com scheduling tools to AI agents via MCP, enabling listing event types, checking availability, and managing bookings (create, cancel, reschedule).67 npmMIT
- AlicenseAqualityBmaintenanceCalendar API purpose-built for AI agents. Exposes tools to manage agents, calendars, and events, find meeting times, run scheduling proposals, set availability rules, manage webhooks, and subscribe to iCal feeds.651,090 npmApache 2.0
- FlicenseNot gradedqualityDmaintenanceExposes personal Calendly account as MCP tools, allowing users to manage events, view availability, and handle bookings through natural language.-