MCP Server

Cal.com scheduling MCP server: manage bookings, event types, and availability.

Remote serverstreamable-httpGo

What is the MCP MCP server?

Connect MCP to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Cal.com scheduling MCP server: manage bookings, event types, and availability. The mcp mcp server is what makes that connection.

What the server does

Part of the AIWerk MCP platform — curated, signed MCP recipes served either as npm packages for self-hosting or through our multi-tenant hosted bridge (bridge.aiwerk.ch).

Installation

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • cal_list_bookings — List bookings with optional filters (status, event type, date range)
  • cal_get_booking — Get details of a specific booking by UID
  • cal_create_booking — Create a new booking (event type, attendee info, time)
  • cal_cancel_booking — Cancel a booking by UID
  • cal_reschedule_booking — Reschedule a booking to a new time
  • cal_list_event_types — List all event types
  • cal_get_event_type — Get event type details by ID
  • cal_create_event_type — Create a new event type
  • cal_update_event_type — Update an existing event type
  • cal_delete_event_type — Delete an event type
  • cal_get_availability — Check available slots for an event type in a date range
  • cal_list_schedules — List all schedules (working hours / availability rules)

Credentials and setup notes

Configuration is passed through the environment: CAL_API_KEY, CAL_BASE_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 13 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. MCP's toolset — cal_list_bookings, cal_get_booking, cal_create_booking and 10 more — is a fair guide to whether it matches your workflow. It is maintained by AIWerk; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
cal_list_bookingsList bookings with optional filters (status, event type, date range)
cal_get_bookingGet details of a specific booking by UID
cal_create_bookingCreate a new booking (event type, attendee info, time)
cal_cancel_bookingCancel a booking by UID
cal_reschedule_bookingReschedule a booking to a new time
cal_list_event_typesList all event types
cal_get_event_typeGet event type details by ID
cal_create_event_typeCreate a new event type
cal_update_event_typeUpdate an existing event type
cal_delete_event_typeDelete an event type
cal_get_availabilityCheck available slots for an event type in a date range
cal_list_schedulesList all schedules (working hours / availability rules)
CursorAdd to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

How to install the MCP MCP server

{
  "mcpServers": {
    "cal": {
      "command": "npx",
      "args": ["@aiwerk/mcp-server-cal"],
      "env": {
        "CAL_API_KEY": "cal_live_your_api_key_here"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
CAL_API_KEYCredential the server authenticates with.Yes
CAL_BASE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use MCP to cal list bookings.
  • Use MCP to cal get booking.
  • Use MCP to cal create booking.

Frequently asked questions

It connects MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 13 tools (cal_list_bookings, cal_get_booking, cal_create_booking, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP directly.