# Calendly

```json
{
  "name": "Calendly",
  "slug": "calendly",
  "url": "https://composio.dev/toolkits/calendly",
  "markdown_url": "https://composio.dev/toolkits/calendly.md",
  "logo_url": "https://logos.composio.dev/api/calendly",
  "categories": [
    "scheduling & booking"
  ],
  "is_composio_managed": true,
  "updated_at": "2026-05-12T10:04:47.950Z"
}
```

![Calendly logo](https://logos.composio.dev/api/calendly)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Calendly MCP or direct API to schedule meetings, check open time slots, send invites, and manage event reminders through natural language.

## Summary

Calendly is an appointment scheduling tool that automates meeting invitations, availability checks, and reminders. It helps individuals and teams avoid endless email back-and-forth when booking meetings.

## Categories

- scheduling & booking

## Toolkit Details

- Tools: 51
- Managed auth: Managed by Composio

## Images

- Logo: https://logos.composio.dev/api/calendly

## Authentication

- **Oauth2**
  - Type: `oauth2`
  - Description: Oauth2 authentication for Calendly.
  - Setup:
    - Configure Oauth2 credentials for Calendly.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Create a single-use scheduling link for my next meeting
- Cancel my 2pm event with a reason
- Mark an invitee as no-show for today's appointment
- Delete all invitee data for privacy compliance

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `CALENDLY_CANCEL_SCHEDULED_EVENT` | Cancel scheduled event | Tool to cancel a scheduled Calendly event by creating a cancellation record. Use when you need to permanently cancel an existing, active event. The cancellation will trigger notifications to all invitees. |
| `CALENDLY_CREATE_EVENT_TYPE` | Create Event Type | Tool to create a new one-on-one event type (kind: solo) in Calendly. Use when you need to programmatically create a new event type for scheduling meetings. |
| `CALENDLY_CREATE_ONE_OFF_EVENT_TYPE` | Create One-Off Event Type | Creates a temporary Calendly one-off event type for unique meetings outside regular availability, requiring valid host/co-host URIs, a future date/range for `date_setting`, and a positive `duration`. |
| `CALENDLY_CREATE_SCHEDULING_LINK` | Create scheduling link | Create a single-use scheduling link. Creates a scheduling link that can be used to book an event. The link allows invitees to schedule up to the specified maximum number of events. Once the limit is reached, the link becomes inactive. |
| `CALENDLY_CREATE_SHARE` | Create share | Creates a customizable, one-time share link for a Calendly event type, allowing specific overrides to its settings (e.g., duration, availability, location) without altering the original event type. |
| `CALENDLY_CREATE_SINGLE_USE_SCHEDULING_LINK` | Create single use scheduling link | Creates a one-time, single-use scheduling link for an active Calendly event type, expiring after one booking. |
| `CALENDLY_CREATE_WEBHOOKS` | Create webhook subscription | Tool to create a webhook subscription for receiving Calendly event notifications. Use when you need to set up automated notifications for events like meeting bookings or cancellations. Organization scope triggers webhooks for all events organization-wide, while user/group scopes limit triggering to specific users or groups. |
| `CALENDLY_DELETE_INVITEE_DATA` | Delete invitee data | Permanently removes all invitee data associated with the provided emails from past organization events, for data privacy compliance (requires Enterprise subscription; deletion may take up to one week). |
| `CALENDLY_DELETE_INVITEE_NO_SHOW` | Delete invitee no show | Deletes an Invitee No-Show record by its `uuid` to reverse an invitee's 'no-show' status; the `uuid` must refer to an existing record. |
| `CALENDLY_DELETE_ORGANIZATION_MEMBERSHIP` | Delete organization membership | Tool to remove a user from a Calendly organization by membership UUID. Use when you need to revoke a user's access to an organization. Requires admin rights; organization owners cannot be removed. |
| `CALENDLY_DELETE_SCHEDULED_EVENT_DATA` | Delete scheduled event data | For Enterprise users, initiates deletion of an organization's scheduled event data between a `start_time` and `end_time` (inclusive, where `start_time` must be <= `end_time`); actual data deletion may take up to 7 days to complete. |
| `CALENDLY_DELETE_WEBHOOK_SUBSCRIPTION` | Delete webhook subscription | Deletes an existing webhook subscription to stop Calendly sending event notifications to its registered callback URL; this operation is idempotent. |
| `CALENDLY_GET_EVENT` | Get event | Use to retrieve a specific Calendly scheduled event by its UUID, provided the event exists in the user's Calendly account. |
| `CALENDLY_GET_EVENT_INVITEE` | Get event invitee | Retrieves detailed information about a specific invitee of a scheduled event, using their unique UUIDs. |
| `CALENDLY_GET_EVENT_TYPE` | Get event type | Retrieves details for a specific Calendly event type, identified by its UUID, which must be valid and correspond to an existing event type. |
| `CALENDLY_GET_EVENT_TYPE_AVAILABILITY` | Get event type availability | Tool to retrieve availability schedules configured for a specific Calendly event type. Use when you need to get the availability rules including day-of-week schedules and date-specific overrides. |
| `CALENDLY_GET_GROUP` | Get group | Retrieves all attributes of a specific Calendly group by its UUID; the group must exist. |
| `CALENDLY_GET_GROUP_RELATIONSHIP` | Get group relationship | Retrieves a specific Calendly group relationship by its valid and existing UUID, providing details on user-group associations and membership. |
| `CALENDLY_GET_INVITEE_NO_SHOW` | Get invitee no show | Retrieves details for a specific Invitee No Show record by its UUID; an Invitee No Show is marked when an invitee does not attend a scheduled event. |
| `CALENDLY_GET_ORGANIZATION` | Get organization | Tool to retrieve information about a specific Calendly organization. Use when you need to get organization details such as name, slug, or timestamps. |
| `CALENDLY_GET_ORGANIZATION_INVITATION` | Get organization invitation | Retrieves a specific Calendly organization invitation using its UUID and the parent organization's UUID. |
| `CALENDLY_GET_ORGANIZATION_MEMBERSHIP` | Get organization membership | Retrieves a specific Calendly organization membership by its UUID, returning all its attributes. |
| `CALENDLY_GET_ROUTING_FORM` | Get routing form | Retrieves a specific routing form by its UUID, providing its configuration details including questions and routing logic. |
| `CALENDLY_GET_ROUTING_FORM_SUBMISSION` | Get routing form submission | Tool to retrieve details about a specific routing form submission by its UUID. Use when you need submission details including questions, answers, and routing results. |
| `CALENDLY_GET_SAMPLE_WEBHOOK_DATA` | Get sample webhook data | Tool to retrieve sample webhook payload data for testing webhook subscriptions. Use when you need to verify webhook setup and understand the data structure before creating actual webhook subscriptions. |
| `CALENDLY_GET_USER` | Get user | Retrieves comprehensive details for an existing Calendly user. |
| `CALENDLY_GET_USER_AVAILABILITY_SCHEDULE` | Get user availability schedule | Retrieves an existing user availability schedule by its UUID; this schedule defines the user's default hours of availability. |
| `CALENDLY_GET_WEBHOOK_SUBSCRIPTION` | Get webhook subscription | Retrieves the details of an existing webhook subscription, identified by its UUID, including its callback URL, subscribed events, scope, and state. |
| `CALENDLY_INVITEE_NO_SHOW` | Mark invitee as no-show | Tool to mark an invitee as a no-show for a scheduled event. Use when an invitee fails to attend their scheduled meeting and you need to record their absence in Calendly. |
| `CALENDLY_LIST_ACTIVITY_LOG_ENTRIES` | List activity log entries | Retrieves a list of activity log entries for a specified Calendly organization (requires an active Enterprise subscription), supporting filtering, sorting, and pagination. |
| `CALENDLY_LIST_EVENT_INVITEES` | List event invitees | Retrieves a list of invitees for a specified Calendly event UUID, with options to filter by status or email, and sort by creation time. |
| `CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES` | List event type available times | Fetches available time slots for a Calendly event type within a specified time range; results are not paginated. |
| `CALENDLY_LIST_EVENT_TYPE_MEMBERSHIPS` | List event type hosts | Tool to retrieve a list of event type hosts (memberships) for a specific event type. Use when you need to see which users are configured as hosts for an event type. |
| `CALENDLY_LIST_EVENT_TYPES` | List Event Types | Tool to list all Event Types associated with a specified User or Organization. Use when you need to retrieve event types for a user or organization. Use scheduling_url from results directly; do not manually construct event type URLs. |
| `CALENDLY_LIST_GROUP_RELATIONSHIPS` | List group relationships | Retrieves a list of group relationships defining an owner's role (e.g., member, admin) within a group; an owner can have one membership per group but multiple admin roles across different groups. |
| `CALENDLY_LIST_GROUPS` | List groups | Returns a list of groups for a specified Calendly organization URI, supporting pagination. |
| `CALENDLY_LIST_ORGANIZATION_INVITATIONS` | List organization invitations | Retrieves a list of invitations for a specific organization, identified by its UUID. |
| `CALENDLY_LIST_ORGANIZATION_MEMBERSHIPS` | List organization memberships | Retrieves a list of organization memberships. |
| `CALENDLY_LIST_OUTGOING_COMMUNICATIONS` | List outgoing communications | Retrieves a list of outgoing SMS communications for a specified organization; requires an Enterprise subscription and if filtering by creation date, both `min_created_at` and `max_created_at` must be provided to form a valid range. |
| `CALENDLY_LIST_ROUTING_FORMS` | List routing forms | Retrieves routing forms for a specified organization; routing forms are questionnaires used to direct invitees to appropriate booking pages or external URLs. |
| `CALENDLY_LIST_SCHEDULED_EVENTS` | List scheduled events | Tool to retrieve a list of scheduled Calendly events. Use when you need to view events for a specific user, organization, or group. Requires exactly one of user, organization, or group parameter to scope the query. |
| `CALENDLY_LIST_USER_AVAILABILITY_SCHEDULES` | List user availability schedules | Retrieves all availability schedules for the specified Calendly user. |
| `CALENDLY_LIST_USER_BUSY_TIMES` | List user busy times | Fetches a user's busy time intervals (internal and external calendar events) in ascending order for a period up to 7 days; keyset pagination is not supported. |
| `CALENDLY_LIST_USER_LOCATIONS` | List User Meeting Locations | Tool to retrieve configured meeting location information for a given Calendly user. Use when you need to see all available location options configured by a user for their meetings. |
| `CALENDLY_LIST_WEBHOOK_SUBSCRIPTIONS` | List webhook subscriptions | Retrieves webhook subscriptions for a Calendly organization; `scope` determines if `user` or `group` URI is also required for filtering. |
| `CALENDLY_ORGANIZATION_INVITATION` | Invite user to organization | Tool to invite a user to a Calendly organization via email. Use when you need to send an organization invitation to a new user. Requires organization owner or admin privileges. |
| `CALENDLY_POST_INVITEE` | Create Event Invitee | Tool to create a new Event Invitee with standard notifications, calendar invites, reschedules, and workflows. Use when programmatically scheduling meetings via API. Requires paid Calendly plan (Standard+). |
| `CALENDLY_REMOVE_USER_FROM_ORGANIZATION` | Remove user from organization | Removes a user (who is not an owner) from an organization by their membership UUID, requiring administrative privileges. |
| `CALENDLY_REVOKE_USER_S_ORGANIZATION_INVITATION` | Revoke a user's organization invitation | Revokes a pending and revokable (not yet accepted or expired) organization invitation using its UUID and the organization's UUID, rendering the invitation link invalid. |
| `CALENDLY_UPDATE_EVENT_TYPE` | Update Event Type | Tool to update an existing one-on-one event type (kind: solo) in Calendly. Use when you need to modify event type settings such as name, duration, location, or description. NOTE: Currently only supports one-on-one event types. |
| `CALENDLY_UPDATE_EVENT_TYPE_AVAILABILITY` | Update Event Type Availability | Tool to update an event type availability schedule in Calendly. Use when you need to change the timezone or availability rules for an event type. WARNING: Updating rules will overwrite all existing rules - retrieve existing rules first using GET /event_type_availability_schedules. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Calendly Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Calendly actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Create a single-use Calendly scheduling link for a 30-minute meeting next week.'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a single-use Calendly scheduling link for a 30-minute meeting next week.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and Claude Agent SDK
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Create Tool Router Session

Initialize the Composio client and create a Tool Router session
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Calendly tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Create a single-use scheduling link for a 30-minute meeting')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Create a single-use scheduling link for a 30-minute meeting' }],
  stopWhen: stepCountIs(5)
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Calendly Integration

- Supports both Calendly MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Calendly data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Calendly access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Calendly
- Scoped, least privilege access to Calendly resources
- Full audit trail of agent actions to support review and compliance

## Use Calendly with any AI Agent Framework

Choose a framework you want to connect Calendly with:

- [ChatGPT](https://composio.dev/toolkits/calendly/framework/chatgpt)
- [OpenAI Agents SDK](https://composio.dev/toolkits/calendly/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/calendly/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/calendly/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/calendly/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/calendly/framework/codex)
- [Cursor](https://composio.dev/toolkits/calendly/framework/cursor)
- [VS Code](https://composio.dev/toolkits/calendly/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/calendly/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/calendly/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/calendly/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/calendly/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/calendly/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/calendly/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/calendly/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/calendly/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/calendly/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/calendly/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/calendly/framework/autogen)

## Related Toolkits

- [Google Calendar](https://composio.dev/toolkits/googlecalendar) - Google Calendar is a time management service for scheduling meetings, events, and reminders. It streamlines personal and team organization with integrated notifications and sharing options.
- [Apaleo](https://composio.dev/toolkits/apaleo) - Apaleo is a cloud-based property management platform for hospitality businesses. It centralizes reservations, billing, and daily operations for smoother hotel management.
- [Appointo](https://composio.dev/toolkits/appointo) - Appointo is an appointment booking platform for Shopify stores. It lets businesses add online scheduling to their websites with zero coding.
- [Bart](https://composio.dev/toolkits/bart) - Bart is the Bay Area Rapid Transit system, providing fast public transportation across the San Francisco Bay Area. It helps commuters and travelers get real-time schedule info, plan routes, and stay updated on service changes.
- [Bookingmood](https://composio.dev/toolkits/bookingmood) - Bookingmood is commission-free booking software for rental businesses. It lets you manage reservations and sync bookings directly on your website.
- [Booqable](https://composio.dev/toolkits/booqable) - Booqable is a rental software platform for managing inventory, bookings, and reservations. It helps businesses streamline rentals and keep track of every item with ease.
- [Cal](https://composio.dev/toolkits/cal) - Cal is a meeting scheduling platform that offers shareable booking links and real-time calendar syncing. It streamlines the process of finding mutual availability to make scheduling effortless.
- [Calendarhero](https://composio.dev/toolkits/calendarhero) - Calendarhero is a powerful scheduling platform that streamlines your calendar management across multiple services. It helps you efficiently schedule, reschedule, and organize meetings without the back-and-forth.
- [Etermin](https://composio.dev/toolkits/etermin) - eTermin is an online appointment scheduling platform for businesses to manage bookings. It streamlines client appointments, saving time and reducing scheduling conflicts.
- [Evenium](https://composio.dev/toolkits/evenium) - Evenium is an all-in-one platform for managing professional events, from planning to analysis. It helps teams simplify event logistics, boost engagement, and track every detail in one place.
- [Eventee](https://composio.dev/toolkits/eventee) - Eventee is a user-friendly event management platform for mobile and web. It boosts attendee engagement for in-person, virtual, and hybrid events.
- [Eventzilla](https://composio.dev/toolkits/eventzilla) - Eventzilla is an event management platform for creating, promoting, and running events. It streamlines ticketing, registration, and attendee coordination for organizers.
- [Humanitix](https://composio.dev/toolkits/humanitix) - Humanitix is a not-for-profit ticketing platform that donates 100% of profits to charity. It empowers event organizers to make social impact with every ticket sold.
- [Lodgify](https://composio.dev/toolkits/lodgify) - Lodgify is an all-in-one vacation rental software for property managers and owners. It centralizes bookings, guest messaging, and channel synchronization in one dashboard.
- [Planyo Online Booking](https://composio.dev/toolkits/planyo_online_booking) - Planyo Online Booking is a flexible reservation system for managing bookings by day, hour, or event. It streamlines scheduling for any business needing reservations.
- [Scheduleonce](https://composio.dev/toolkits/scheduleonce) - Scheduleonce is a scheduling platform for capturing, qualifying, and engaging with inbound leads. It streamlines appointment booking and follow-ups for faster lead conversion.
- [Supersaas](https://composio.dev/toolkits/supersaas) - Supersaas is a flexible appointment scheduling platform for businesses and individuals. It streamlines bookings, reminders, and calendar management in one place.
- [Sympla](https://composio.dev/toolkits/sympla) - Sympla is a platform for managing in-person and online events, ticket sales, and registrations. It streamlines event setup, attendee tracking, and digital content delivery.
- [Gmail](https://composio.dev/toolkits/gmail) - Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable.
- [Google Drive](https://composio.dev/toolkits/googledrive) - Google Drive is a cloud storage platform for uploading, sharing, and collaborating on files. It's perfect for keeping your documents accessible and organized across devices.

## Frequently Asked Questions

### Do I need my own developer credentials to use Calendly with Composio?

No, you can get started immediately using Composio's built-in Calendly app. For production, we recommend configuring your own OAuth credentials.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)