Cal Com MCP Server — Hosted Api Connectors Integration
MCP Server language Hosted language PublicBook meetings, check availability, and manage your entire scheduling workflow programmatically via Cal.com.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"cal-com": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-cal-com",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the _ping tool to verify cal.com credentials by calling a lightweight read endpoint. used internally by aerostack to validate credentials”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
description Overview
mcp-cal-com — Cal.com MCP Server
Let AI agents manage your entire scheduling workflow — create event types, check availability, book meetings, and handle cancellations automatically.
Cal.com is the open-source scheduling infrastructure used by thousands of businesses. This MCP server gives your agents full control over the Cal.com API: managing bookable event types, checking real-time availability, creating and rescheduling bookings, and tracking no-shows — all without human intervention.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-cal-com
What You Can Do
- Check real-time availability and book meetings on behalf of users or customers
- Create and manage event types (e.g. "30-min demo", "1-hour consultation") programmatically
- Reschedule or cancel bookings with reason tracking for CRM integration
- Build automated scheduling workflows that react to leads, form submissions, or Slack messages
Available Tools
| Tool | Description |
|---|---|
| list_event_types | List all bookable event types for the authenticated user |
| get_event_type | Get full details of a specific event type by ID |
| create_event_type | Create a new bookable event type with duration, slug, and locations |
| delete_event_type | Delete an event type by ID |
| list_bookings | List bookings with optional status and attendee email filters |
| get_booking | Get full details of a specific booking by UID |
| create_booking | Create a new booking for an event type with attendee details |
| reschedule_booking | Reschedule an existing booking to a new start time |
| cancel_booking | Cancel a booking with an optional cancellation reason |
| mark_no_show | Mark the host as a no-show on a booking |
| get_availability | Get available time slots for an event type within a date range |
| get_busy_times | Get blocked time periods for a user — useful for conflict detection |
| list_schedules | List all recurring availability schedules for the authenticated user |
| get_me | Get the authenticated Cal.com user's profile and settings |
| update_me | Update the authenticated user's time zone, name, or time format |
Configuration
| Variable | Required | Description | How to Get |
|---|---|---|---|
| CAL_COM_API_KEY | Yes | Cal.com API key | app.cal.com → Settings → Developer → API Keys |
Quick Start
Add to Aerostack Workspace
- Go to aerostack.dev → Your Project → MCPs
- Search for "Cal.com" and click Add to Workspace
- Add your
CAL_COM_API_KEYunder Project → Secrets
Once added, every AI agent in your workspace can book and manage meetings automatically — no per-user setup needed.
Example Prompts
"Check availability for a 30-minute call next Tuesday and book the first open slot for john@example.com"
"Show me all upcoming bookings for this week"
"Cancel the meeting with uid abc123xyz — the client requested a reschedule"
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-cal-com \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-CAL-COM-API-KEY: your-key' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_availability","arguments":{"event_type_id":123,"start_time":"2024-08-13T00:00:00Z","end_time":"2024-08-20T23:59:59Z"}}}'
License
MIT
terminal Tools (16)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
_ping #1 Verify Cal.com credentials by calling a lightweight read endpoint. Used internally by Aerostack to validate credentials.
list_event_types #2 List all event types for the authenticated user. Event types define bookable slots — e.g. "30 min call", "1 hour consultation". Returns id, title, slug, length (minutes), and description.
get_event_type #3 Get full details of a specific event type by ID, including locations, scheduling constraints, and metadata.
create_event_type #4 Create a new bookable event type. Defines a meeting template with title, URL slug, duration (minutes), optional description, and meeting locations (in-person address, video link, or integration like Google Meet).
delete_event_type #5 Delete an event type by ID. This removes the booking page and prevents future bookings. Existing bookings are NOT cancelled.
list_bookings #6 List bookings with optional filters for status, attendee email, pagination. Returns booking UID, title, start/end times, attendees, and status.
get_booking #7 Get full details of a specific booking by UID — attendees, event type, start/end, location, metadata, and status.
create_booking #8 Create a new booking for an event type. Requires the event type ID, start time (ISO 8601), and attendee details. Use get_availability first to find open slots.
reschedule_booking #9 Reschedule an existing booking to a new start time. Provide a rescheduling reason and the new ISO 8601 start datetime. Use get_availability to find open slots first.
cancel_booking #10 Cancel an existing booking by UID. Optionally provide a cancellation reason.
mark_no_show #11 Mark the host as a no-show for a booking. Sets noShowHost=true on the booking record.
get_availability #12 Get available time slots for an event type within a date range. Returns slots grouped by date. Use this before create_booking to find open times.
get_busy_times #13 Get busy/blocked time periods for a user within a date range. Useful for calendar conflict detection.
list_schedules #14 List all availability schedules for the authenticated user. Schedules define recurring weekly availability windows (e.g. Mon-Fri 9am-5pm).
get_me #15 Get the profile of the authenticated Cal.com user — name, email, time zone, week start, time format, and account settings.
update_me #16 Update profile settings for the authenticated user — name, time zone, week start day, or time format (12/24h).
Details
language Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-cal-com
Sub-50ms globally · Zero cold start
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in API Connectors
Browse API Connectors MCPs →Aerostack Registry
by @aerostack
Discover and invoke any MCP, Function, or Skill published to the Aerostack marketplace — the universal AI capability hub.
Algolia
by @aerostack
Search indexes, manage records, browse data, and configure ranking in Algolia — AI-native instant search access.
Arangodb
by @aerostack
Query documents, run AQL, traverse graphs, and manage collections in your ArangoDB database — AI-native multi-model database access.
Ayrshare
by @aerostack
Post, schedule, and analyze social media across 13 platforms — Facebook, Instagram, X, LinkedIn, TikTok, Bluesky, Threads, Reddit, Pinterest, YouTube, Telegram, Snapchat, Google Business.
Basecamp
by @aerostack
Manage projects, to-dos, messages, schedules, and campfire chats in Basecamp — AI-native project management.
Bigquery
by @aerostack
Run SQL queries, list datasets and tables, inspect schemas, and export results from Google BigQuery — AI-native data warehouse access.
Frequently asked questions
What is the Cal Com MCP server and what can it do? +
The Cal Com MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `list_event_types`, `get_event_type`, `create_event_type`, `delete_event_type`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.
Is the Cal Com MCP server hosted, or do I have to run it myself? +
It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.
Which AI agents and editors can use the Cal Com MCP server? +
Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same Cal Com MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.
How do I install the Cal Com MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-cal-com": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-cal-com"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the Cal Com MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-cal-com", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-cal-com"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does Cal Com MCP require authentication? +
Yes. Cal Com requires authentication. Check the MCP's documentation for the required credentials.