> For the complete documentation index, see [llms.txt](https://docs.eesel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eesel.ai/integrations/communication/calendly.md). # Calendly Give your agent a read-only view of Calendly so it answers who a meeting is with, who is hosting and whether it is still on, and posts a daily schedule to Slack. Give your agent a view of your Calendly bookings and it answers the questions your team asks each other. Who the Friday demo is with, who is hosting, whether it is still on, what the customer wrote when they booked. It reads Calendly live. This is a read-only skill. Setup is one Calendly personal access token, pasted into a secure field.

Slack's general channel with a Next 3 demos post from the eesel app, listing three invitees with their times and the notes they left when booking — The day's demos posted to Slack every morning, with the note each customer left when booking.

## Quick start {% stepper %} {% step %} ### Ask your agent what it can do with Calendly Open the chat in your dashboard and ask. Your agent explains what it can look up, what it cannot do, and the one thing it needs: a personal access token from Calendly. It also tells you that the token goes into the skill's settings, not into the chat.

The dashboard chat where the user asks what the agent can do with Calendly, and the agent lists what it can look up, what it cannot do, and the two steps to add a personal access token — The agent's answer in the dashboard chat.

Decide who creates the token. A token from an ordinary team member only shows that person's bookings. A token from a Calendly admin or owner shows everyone's, so your agent can answer "who on the team hosted the demo with this customer". {% endstep %} {% step %} ### Open the skill Open **Skills** in the left sidebar and find **Look up Calendly meetings**. Click the tile to open it.

The Skills page filtered to Calendly, showing the Look up Calendly meetings tile with an Ask eesel button — The Calendly skill on the Skills page.

The skill's page describes what it does and has an **Install skill** button at the top right. Click it.

The Look up Calendly meetings skill page with its description, the five things it can do, an Install skill button and the skill's contents — The skill's page, with Install skill at the top right.

A **Settings** section appears below the contents, with one field: **Calendly Personal Access Token**.

The skill page scrolled down to Settings, showing the empty Calendly Personal Access Token field with a note that it needs the Scheduling and User management scopes from an admin or owner — The token field, before anything is pasted in.

{% endstep %} {% step %} ### Create the token in Calendly In Calendly, open **Integrations & apps > API & webhooks** and click **Create a token**. A token you create as an admin covers everyone in your Calendly organization, and Calendly says so on the page.

Calendly's personal access tokens page with a note that admin tokens grant access to data for everyone in the organization, a Create a token button and one token named eesel — Calendly's personal access tokens page.

Name it, tick at least the **Scheduling** and **User management** scopes, and click **Next**. Calendly shows the token once. Copy it.

Calendly's Create a personal access token dialog with the name eesel and the Scheduling, User management, Contacts and Notetaker scopes ticked — Name the token and tick the scopes.

{% endstep %} {% step %} ### Paste the token into the skill's settings Back in eesel, paste the token into the **Calendly Personal Access Token** field. It shows as dots, not text. It is stored securely and used only to call Calendly. Your agent never sees the value.

The skill's Settings section with the token field filled in as hidden dots, and an Activity list below showing the setup chat — The token saved, hidden as dots.

**Check it worked.** Ask your agent in chat what meetings are coming up. If the token is missing or wrong, it says so and points you back to this field. {% endstep %} {% step %} ### Ask about a booking Ask about your calendar in plain words. Your agent lists the bookings with the date, the time in UTC and whether each one is still active.

The dashboard chat where the user asks what demos are coming up, and the agent answers with a table of six bookings with their times in UTC, one of them canceled — The week's demos, with one canceled.

Ask about one booking and it names the invitee, the time, the host, the status, and anything the invitee wrote when they booked.

The same chat where the user asks who the Friday demo is with, and the agent answers with the invitee's name and email, the time, the host, the status and the note left at booking — The invitee, time, host, status and booking note for one demo.

{% endstep %} {% step %} ### Put it on a schedule With Calendly, an automation is a [schedule](/automations-and-schedules/automations-and-schedules.md). Ask for the day's demos in a Slack channel every morning and your agent creates it, confirms the time, and offers to run it once so you can see the post.

The dashboard chat where the user asks for the day's Calendly demos posted to a Slack channel every morning, and the agent confirms the schedule at 9 AM UTC and offers a test run — The agent confirming the 9 AM UTC schedule and offering a test run.

It appears on your **Automations** page, switched on.

The Automations page listing Daily Calendly demos to general, 9:00 AM every day UTC, marked Schedule and switched on, beside the chat that created it — The schedule on your Automations page.

Open it to change the time or the timezone. Here the time has been moved to 8:30 AM.

The schedule editor with How often set to Daily, 8:30 AM and UTC chosen, and a line reading Every day at 8:30 AM (UTC) — The schedule editor.

Below the schedule settings are the instructions: what to look up, what to pull out of each booking, and where to post it.

The schedule editor scrolled to the instructions, which say to look up upcoming Calendly bookings, take the three soonest, extract the invitee, time and booking notes, and post them to the general Slack channel — The instructions the schedule follows.

**Check it worked.** From a terminal, `eesel automations` lists the schedule as on. {% endstep %} {% step %} ### Check the post in Slack Open the channel. The post lists the three soonest demos with the invitee, the time and their booking note.

{% endstep %} {% endstepper %} {% hint style="info" %} **From Claude Code, Cursor or a terminal.** The token step is a human step: someone on your team creates the token in Calendly and pastes it into the skill's settings in the dashboard. Do not ask for it in chat or paste it into a command. Once it is in, `eesel chat "what demos are coming up?"` asks the same question the dashboard chat does, and `eesel automations` shows the schedule once it exists. Full command reference: [The eesel CLI](/apis-and-developer-resources/cli.md). From a Model Context Protocol client: [Claude Code and MCP clients](/apis-and-developer-resources/claude-code-and-mcp-clients.md). {% endhint %} ## What it can look up | Ask | What comes back | | ---------------------------------------- | --------------------------------------------------------------------------------- | | What meetings are coming up | The connected account's upcoming bookings, soonest first, with the status of each | | Who the meeting with a customer is with | Bookings for that invitee's email address, upcoming or past | | Who hosted a call | The host on the booking | | Whether a booking is still on | Active, canceled or rescheduled | | What the customer wrote when they booked | The booking note and any answers to your booking questions | It cannot book, cancel or reschedule, and it cannot tell you whether someone showed up. Calendly only knows about the booking. ## Troubleshooting

Your agent says the Calendly connection is not configured?

The token is missing or has been revoked. Open **Skills > Look up Calendly meetings** and paste a current token into the **Calendly Personal Access Token** field.

It only shows one person's bookings?

The token belongs to an ordinary team member, so Calendly only shares that person's calendar. Create the token as a Calendly admin or owner and paste that one in instead.

The times look wrong?

Times in the chat are in UTC. Ask for your timezone and your agent converts. In a scheduled post, say which timezone to use in the instructions.

## FAQ

Can my agent book or cancel a meeting?

No. The skill only reads Calendly. Booking, cancelling and rescheduling stay in Calendly.

Can it tell me if the customer turned up?

No. Calendly records the booking, not attendance.

Is there a Calendly trigger?

No. Use a [schedule](/automations-and-schedules/automations-and-schedules.md), for example a morning post of the day's demos.

How is this billed?

Pay-as-you-go. A scheduled run is one task. Chatting with your agent in the dashboard is free. See [Pricing](/pricing/overview.md).

## Related pages * [Skills](/skills/skills.md) for how skills work, since Calendly runs as the Look up Calendly meetings skill * [Automations and Schedules](/automations-and-schedules/automations-and-schedules.md) for how schedules work * [Slack](/integrations/communication/slack.md) for posting the day's demos to a channel * [Set up from Claude Code or the terminal](/getting-started/set-up-from-a-coding-agent.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.eesel.ai/integrations/communication/calendly.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.