Calendly Integration

Pro v1.0.0

Access the Calendly scheduling platform API to manage events, check availability, and retrieve user data

Requires Claude Code CLI

This skill integrates with Calendly through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

Get Current User

Retrieve information about the authenticated user including name, email, scheduling URL, and timezone

Returns

object User resource with profile information

Try saying...

  • "Get my Calendly user information"
  • "Show my Calendly profile details"
  • "What's my Calendly scheduling URL?"

List Event Types

Get all event types configured for a user, including meeting durations, URLs, and availability settings

Parameters

Name Type Required Description
user_uri string Required URI of the user whose event types to retrieve

Returns

object Collection of event type resources

Try saying...

  • "List all my Calendly event types"
  • "Show my available meeting types"
  • "What event types do I have configured?"

List Scheduled Events

Retrieve all scheduled events with invitee information and meeting details

Parameters

Name Type Required Description
user_uri string Optional Optional user URI to filter events

Returns

object Collection of scheduled event resources

Try saying...

  • "Show all my upcoming Calendly meetings"
  • "List my scheduled events"
  • "What meetings do I have on my Calendly calendar?"

Get Event Type Availability

Get available time slots for a specific event type within a date range (max 7 days)

Parameters

Name Type Required Description
event_type_uri string Required URI of the event type
start_time string Required Start of time range in ISO 8601 format
end_time string Required End of time range in ISO 8601 format (max 7 days from start)

Returns

object Collection of available time slots

Try saying...

  • "What times are available for my 30-minute meeting next week?"
  • "Show available slots for this event type"
  • "When can people book this meeting type?"

Get User Busy Times

Retrieve busy time blocks when a user is unavailable within a date range (max 7 days)

Parameters

Name Type Required Description
user_uri string Required URI of the user
start_time string Required Start of time range in ISO 8601 format
end_time string Required End of time range in ISO 8601 format (max 7 days from start)

Returns

object Collection of busy time blocks

Try saying...

  • "When am I busy next week?"
  • "Show my unavailable times"
  • "What times are blocked on my calendar?"

Cancel Event

Cancel a scheduled event by its UUID

Parameters

Name Type Required Description
event_uuid string Required UUID of the event to cancel

Returns

boolean Success confirmation

Try saying...

  • "Cancel my Calendly meeting with ID abc123"
  • "Remove this scheduled event"
  • "Cancel this booking"

Getting Started

API Key Easy Setup
  1. 1 Log in to your Calendly account
  2. 2 Navigate to Integrations > API & Webhooks
  3. 3 Click 'Generate new token' or 'Get a token now'
  4. 4 Give your token a descriptive name
  5. 5 Click 'Create Token' and copy it immediately (shown only once)
  6. 6 Add to shell config: echo 'export CALENDLY_API_KEY="YOUR_TOKEN"' >> ~/.zshrc
  7. 7 Restart terminal or run: source ~/.zshrc

Verify Setup

python scripts/client.py get-user

Success: Returns user information with name, email, and scheduling URL

View full setup guide

Security & Access

Access Scope

Full access to authenticated user's Calendly account including viewing events, event types, user information, and canceling events

  • Personal Access Token grants full access to your Calendly account
  • Never share tokens publicly or commit them to version control
  • Tokens cannot be recovered after creation - store securely immediately
  • Create separate tokens for different integrations
  • Revoke unused tokens from the Integrations page

Limitations

  • Cannot create events via API (use Calendly embed widget instead)
  • Cannot set user availability or working hours via API
  • Cannot create event types via API
  • Availability and busy time queries limited to 7-day maximum range
  • Webhooks require paid plan (Standard or higher)

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
REST API
Auth
API Key
Setup
Easy Setup
Tools Required
Bash
Python Dependencies
requests>=2.28.0

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements