> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendly

> Read scheduling links, scheduled events, and invitees from Calendly, and cancel events

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Docs**: [https://developer.calendly.com/api-docs](https://developer.calendly.com/api-docs)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable                 | Required | Description                                                                                     |
| ------------------------ | -------- | ----------------------------------------------------------------------------------------------- |
| `CALENDLY_CLIENT_ID`     | Yes      | Calendly OAuth Client ID [Docs](https://developer.calendly.com/create-a-developer-account).     |
| `CALENDLY_CLIENT_SECRET` | Yes      | Calendly OAuth Client Secret [Docs](https://developer.calendly.com/create-a-developer-account). |

## Setup

1. **Create a Calendly developer account**: Go to [https://developer.calendly.com](https://developer.calendly.com), sign in with your Calendly account, and create a developer account if you don't have one.
2. **Create an OAuth app**: Create a new OAuth application, choose the environment (sandbox or production), and set the redirect URI to your callback (e.g. [https://your-app.example.com/api/auth/calendly/callback](https://your-app.example.com/api/auth/calendly/callback)).
3. **Set environment variables**: Copy the Client ID and Client Secret into your .env as CALENDLY\_CLIENT\_ID and CALENDLY\_CLIENT\_SECRET.
4. **Verify access**: Connect your Calendly account and run the Get Current User tool - note the returned user and organization URIs, which the list tools take as parameters.

* Calendly OAuth does not use granular scopes - an access token can access everything the user can
* A free Calendly account works for testing; event cancellation requires the connected user to own the event

Provider API reference: [https://developer.calendly.com/api-docs](https://developer.calendly.com/api-docs)

## Tools

| Tool                  | Access | Description                                                                                                |
| --------------------- | ------ | ---------------------------------------------------------------------------------------------------------- |
| Get Current User      | Read   | Get the connected Calendly user, including their user URI and organization URI (needed by the other tools) |
| List Event Types      | Read   | List the user's or organization's event types (scheduling links)                                           |
| List Scheduled Events | Read   | List scheduled events for a user or organization                                                           |
| Get Scheduled Event   | Read   | Get details of a specific scheduled event                                                                  |
| List Event Invitees   | Read   | List invitees of a scheduled event                                                                         |
| Cancel Event          | Write  | Cancel a scheduled event                                                                                   |

## Example prompts

* List my upcoming Calendly events with their times and invitees.
* Show my active Calendly event types and their scheduling URLs.