Cal.com MCP

Released May 1, 2026

Summary

Cal.com's official MCP server: book, reschedule and cancel meetings, manage event types and schedules, and query real availability from a chat client.

Features

~34 tools across bookings, event types, schedules, availability, routing forms and organizations
Hosted endpoint at mcp.cal.com/mcp — Streamable HTTP with OAuth 2.1, no API key to manage
Self-hosted stdio option via npx @calcom/cal-mcp with a CAL_API_KEY
Queries real free/busy data from connected calendars, not a cached view
Compact default tool set, with every Cal.com API endpoint available behind --all-tools
Wraps Cal.com API v2; the platform is open source and self-hostable

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it.
Restart the agent — the "Cal.com MCP" tools will be available.

{
  "mcpServers": {
    "calcom-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.cal.com/mcp"
      ]
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add calcom-mcp -- npx -y mcp-remote https://mcp.cal.com/mcp

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "calcom-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.cal.com/mcp"
      ]
    }
  }
}

Cursor

Or add {"mcpServers":{"calcom":{"url":"https://mcp.cal.com/mcp"}}} to .cursor/mcp.json.

{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://mcp.cal.com/mcp"
  ]
}

VS Code

Add to .vscode/mcp.json, or use the remote URL directly where supported.

{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://mcp.cal.com/mcp"
  ]
}

Self-hosted over stdio. Needs Node.js 18+ and an API key from Cal.com Settings → Developer → API Keys. Append --all-tools to expose every API endpoint.

{
  "command": "npx",
  "args": [
    "@calcom/cal-mcp@latest"
  ],
  "env": {
    "CAL_API_KEY": "cal_live_xxxx"
  }
}

Description

Scheduling is one of the few tasks where an agent's answer is only useful if it is grounded in live calendar state — a proposed slot that is already booked is worse than no answer. Cal.com's official MCP server wraps the Cal.com API v2 in the Model Context Protocol so an assistant works against real bookings and real free/busy data rather than a guess.

Two ways to run it

Hosted (recommended). Point any MCP client at https://mcp.cal.com/mcp. It speaks Streamable HTTP with OAuth 2.1, so there is no API key to mint, paste or rotate — the client walks through an authorization flow on first connect and you grant access to your Cal.com account. Nothing to install or keep updated.

Self-hosted. Run npx @calcom/cal-mcp@latest over stdio with a CAL_API_KEY from Settings → Developer → API Keys. Needs Node.js 18 or later.

What it exposes

Roughly 34 tools spanning six areas:

Bookings — create, retrieve, reschedule, cancel, confirm, and manage attendees
Event types — full create/read/update/delete
Schedules — CRUD plus default-schedule lookup
Availability — open slots and busy times pulled from connected calendars
Routing forms — compute slots from form responses
Organizations and profile — memberships, routing form data, authenticated user info

The npm package ships a smaller default tool set (getBooking, getBookings, createBooking, rescheduleBooking, cancelBooking, getEventTypes, getEventTypeById, updateEventType, deleteEventType) and exposes tools for every Cal.com API endpoint behind the --all-tools / -a flag — a sensible default, since a smaller surface makes tool selection more reliable.

That covers the requests people actually make of a scheduling assistant: "what do I have this week", "reschedule my 2pm to Thursday at 3", "find 30 minutes we both have free before Friday".

Worth knowing: the repository carries an explicit notice that the project is in active development and its APIs may change frequently. Treat it as a fast-moving integration rather than a frozen one, and pin a version if you are wiring it into something durable.

Cal.com itself is the open-source scheduling platform often adopted as a Calendly alternative, self-hostable or run as a managed service.

Related MCP Servers

MCP: Appwrite MCP Server

by Appwrite

Appwrite's official MCP server exposes databases, users, teams, functions and storage as agent tools, over a hosted OAuth endpoint or a local stdio bridge.

Developer Tools

MCP: Google Workspace MCP

by Google

Featured

Google's own remote MCP endpoints for Gmail, Drive, Docs, Sheets, Slides, Calendar, Chat and People — OAuth 2.0, hosted by Google, no server to run.

Productivity

MCP: Fireflies.ai

by Fireflies.ai

Featured

Fireflies.ai's official remote MCP server — 19 tools for searching meeting transcripts and summaries, pulling action items and analytics, and cutting soundbites from recorded calls.

Productivity

MCP: Zoom Workspace MCP Server

by Zoom

Featured

Zoom's official hosted MCP server — semantic meeting search, AI Companion summaries, transcripts, recordings, and cross-Zoom search over Team Chat, Canvas and My Notes.

Productivity

Browse all MCP servers →