# Calendly MCP

> Calendly manages your entire scheduling life cycle through natural conversation. Your AI client can list available time slots, view event templates, check upcoming appointments, or track no-show rates—all without you leaving your workspace. It gives your agent direct control over managing attendees and updating availability across all your meeting types.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** scheduling, appointment-booking, workflow-automation, event-types, availability, meeting-management

## Description

Connect your Calendly account via this MCP to hand off the scheduling headache to your AI client. Instead of juggling multiple tabs between your calendar, CRM, and booking site, you just talk to your agent. It handles the logistics: listing what kind of meetings you offer, checking who is attending an event, or seeing if a specific time slot works for everyone involved.

If you use Vinkius's catalog, this MCP becomes one command center. You can view organizational details, track cancellations and no-shows for accurate reporting, and even get a summary of your week’s commitments. It lets you manage the whole process—from initial booking to follow-up—using only conversation.

## Tools

### get_user
Retrieves your authenticated Calendly profile data, including name and organization membership status.

### list_event_types
Lists every meeting template (or event type) set up for your organization.

### get_event_type
Retrieves the detailed setup information for one specific type of meeting template by its unique ID.

### list_scheduled_events
Lists all past and future appointments for your account in a single view.

### get_scheduled_event
Fetches all details about a single, existing scheduled event using its tracking identifier.

### list_invitees
Gets a list of all people invited to an event, along with their responses and tracking data.

### cancel_event
Cancels a specific scheduled event and optionally sends a cancellation reason to the invitee.

### list_availability
Gets a complete list of all scheduling windows configured for your account.

### get_available_times
Finds open booking time slots for a given meeting template within an exact date range.

### list_org_members
Retrieves the full team structure by listing every member within your Calendly organization.

## Prompt Examples

**Prompt:** 
```
What meetings do I have scheduled for tomorrow?
```

**Response:** 
```
You have 3 meetings tomorrow. 09:00 — Product Demo with Sarah Chen (30 min). 11:00 — Sales Discovery with James Park (45 min). 14:30 — Onboarding Call with Maria Lopez (60 min). Would you like me to pull the invitee details for any of them?
```

**Prompt:** 
```
How many no-shows did we have this week?
```

**Response:** 
```
4 no-shows this week across 28 scheduled events (14.3% rate). Highest concentration on Monday — 2 missed Discovery Calls. The invitees were notified but did not join. I can mark them as no-shows and pull their contact details for follow-up.
```

**Prompt:** 
```
Am I free on Friday afternoon for a 30-minute call?
```

**Response:** 
```
Checking your availability… You have a free slot from 15:00 to 16:30 on Friday. Your 30-Minute Meeting event type is active and has availability in that window. Would you like me to share your scheduling link, or should I create a one-off event?
```

## Capabilities

### Manage meeting templates
List or create specific event types with rules for duration, location, and availability.

### View scheduled appointments
Get full details on past or upcoming events, including attendee names and the final status of the meeting.

### Check real-time free slots
Determine specific blocks of time when you are available for a given event type within a set date range.

### Track attendee data
Retrieve the list of attendees and view their associated tracking parameters or responses.

### Handle user and organization info
Access your profile details, organizational membership, and team structure within Calendly.

## Use Cases

### Tracking missed revenue opportunities
A Sales Rep wants to know why three key prospects didn't join their demo last week. They ask their agent to `list_scheduled_events` for the past seven days, then use `list_invitees` on each event to confirm if they received the reminder and what the final status was.

### Finding a time for a cross-department meeting
An HR manager needs to book a 45-minute session between three managers who operate in different time zones. They ask their agent to `get_available_times` for all three people against the desired date range, solving the scheduling puzzle instantly.

### Reviewing team capacity
An Operations Director needs to know how many people are available on the Marketing team this week. They ask their agent to `list_org_members` and then check that group's overall availability using `list_availability`.

### Adjusting a meeting after an internal change
A CSM realizes the main speaker is unavailable next Tuesday. They ask their agent to use `get_event_type` to verify the original event template and then call `cancel_event`, specifying that the speaker needed to reschedule.

## Benefits

- You'll stop manually cross-referencing calendars. Using the `get_available_times` tool, you ask your agent for free slots, and it finds them across a specific date range immediately.
- No more guessing about who missed a call. The MCP lets you use `list_invitees` to view attendee responses and track exactly who showed up or who was marked as a no-show.
- You maintain full control over your meeting setup. With `list_event_types`, you can let your agent read all the specific templates you've created, from quick 15-minute calls to long demos.
- The system gives you organizational awareness. The `list_org_members` tool lets you check team roles and structures without leaving your primary workflow.
- You streamline follow-up actions. If a meeting needs to be canceled, the agent uses `cancel_event`, ensuring the invitee gets a reason sent automatically.

## How It Works

The bottom line is, once it's connected, your agent handles the API calls using natural language prompts.

1. Subscribe to this MCP on Vinkius.
2. Enter the required Calendly Personal Access Token into your AI client settings.
3. Tell your agent what you need: 'What are my available times next Tuesday?' or 'List all events scheduled for John Doe.'

## Frequently Asked Questions

**How do I check my free time using Calendly MCP?**
You use `get_available_times`. This tool finds open booking slots for a specific event type, letting you know exactly when you can meet within your specified date range.

**Can I see who attended an old meeting with Calendly MCP?**
Yes. You run the `list_invitees` tool on the scheduled event ID. This pulls a list of all attendees, their responses, and any tracking data available.

**How do I manage different types of meetings?**
You can use `list_event_types` to see every template set up. You then pass the specific event type name or UUID to other tools like `get_available_times`.

**What is the best way to find out my team's schedule?**
First, use `list_org_members` to get all user IDs. Then, you can pass those IDs into other tools or check individual availability using `list_availability`.

**How do I use the `cancel_event` tool to manage a canceled meeting?**
You cancel an event and can optionally send a reason directly to the invitee. This keeps your communication loop closed, allowing you to track why the meeting was missed or rescheduled.

**What does the `get_user` tool provide about my account details?**
It retrieves comprehensive profile data, including your name, email address, timezone settings, and current subscription plan. This is helpful for verifying user identity across systems.

**How can I check the specific rules of a meeting template using `get_event_type`?**
This tool pulls all detailed configuration information for any event type UUID. You can verify custom durations, location requirements, and availability constraints set by that template.

**Does the `list_scheduled_events` tool list past or only future appointments?**
The tool lists both past and upcoming events. It pulls a full record of all scheduled meetings associated with your account, regardless of whether they have already taken place.

**Can my AI agent prepare me for my next call in 10 seconds?**
Yes. Ask your agent to list your upcoming events — it returns the invitee name, email, event type, and scheduled time. Combine it with a CRM lookup and you have a complete pre-call brief without opening a single tab. Sales reps who adopted this workflow report saving 5–10 minutes per meeting in context-switching time.

**How can I track no-shows and cancellations across my team?**
Ask your agent to list recent events filtered by status. It surfaces cancellations with their reasons and identifies no-show patterns. Perfect for weekly pipeline reviews — instead of manually exporting Calendly analytics, ask your agent to aggregate the data and highlight trends. Your AI does the number-crunching while you focus on coaching.

**I manage multiple event types for different use cases — can my agent help me audit them?**
Absolutely. List all your event types and your agent shows you each one with its duration, scheduling URL, active/inactive status, and configuration. Spot duplicates, identify unused event types, and clean up your scheduling page — all through a single conversation. No clicking through dozens of Calendly settings pages.