Cal MCP server
Cal.com scheduling MCP server: manage bookings, event types, and availability.
0 stars50 downloads/wk
Reviews
Write oneNobody has reviewed Cal yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Cal tools (12, 5 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
cal_cancel_bookingwrite actionCancel a booking by UID. Required: uid. Optional: cancellationReason.
cal_create_bookingwrite actionCreate a new booking. Required: eventTypeId, start (ISO 8601), attendeeName, attendeeEmail, attendeeTimezone. Optional: notes, guests (array of emails), metadata.
cal_create_event_typewrite actionCreate a new event type. Required: title, slug, lengthInMinutes. Optional: description, locations, hidden, metadata.
cal_delete_event_typewrite actionDelete an event type by ID. Required: id.
cal_get_availabilityGet available time slots for an event type in a date range. Required: eventTypeId, dateFrom (ISO 8601), dateTo (ISO 8601). Optional: timeZone.
cal_get_bookingGet details of a specific booking by its UID. Required: uid.
cal_get_event_typeGet details of a specific event type by ID. Required: id.
cal_list_bookingsList bookings with optional filters. Optional: status (upcoming|recurring|past|cancelled|unconfirmed), eventTypeId, dateFrom (ISO 8601), dateTo (ISO 8601), limit.
cal_list_event_typesList all event types. Optional: teamId, userId to filter by team or user.
cal_list_schedulesList all schedules (working hours and availability rules).
cal_reschedule_bookingReschedule a booking to a new time. Required: uid, newStart (ISO 8601). Optional: reschedulingReason.
cal_update_event_typewrite actionUpdate an existing event type. Required: id. Optional fields to update: title, slug, lengthInMinutes, description, locations, hidden, metadata.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 47 days ago12/15
- Maintainer identityregistry namespace matches repository owner6/10
How Cal compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 75/100
- higher than 45% of 48,273 servers
- Tools
- 12
- the typical server has 7
- Tools that change things
- 42%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 50
- more than 43% of 11,915 servers with a package
What its tools let an agent do: 7 read · 5 change
Install Cal in Claude Code, Cursor or VS Code
Runs npx -y @aiwerk/mcp-server-cal on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-server-cal -- npx -y @aiwerk/mcp-server-cal
What the publisher says
From the Cal repository's README, as published. We do not edit it. Read it on GitHub
@aiwerk/mcp-server-cal
Cal.com scheduling MCP server - manage bookings, event types, and availability directly from your AI assistant.
Why this server?
Connect Claude, Cursor, or any MCP-compatible AI to your Cal.com account. Create bookings, check availability, manage event types, and view schedules - all via natural language.
Install
Two ways to run this server — pick the one that fits.
Option 1 — Hosted (zero setup)
No local runtime, no env vars on your machine — secrets are AES-256-GCM encrypted server-side via HashiCorp Vault.
- Sign up at aiwerkmcp.com.
- Install Cal.com from the catalog and paste your CALAPIKEY.
- Point your MCP client (Claude.ai, Cursor, Hermes, …) at your hosted endpoint:
https://bridge.aiwerk.ch/u/<your-user-id>/mcpwith your Bearer token.
All 12 tools, 3 resources, and 3 prompts appear. Install other AIWerk recipes from the same bridge.
Option 2 — Self-hosted (npx)
Run directly — you manage the API key:
CAL_API_KEY=cal_live_your_api_key_here npx @aiwerk/mcp-server-calOr wire it into your MCP client config — see Configuration below.
Tools
Resources
Resources are automatically available in the AI's context — no need to ask for them.
Prompts
Ready-made prompt templates for common scheduling tasks.
Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claudedesktopconfig.json:
{
"mcpServers": {
"cal": {
"command": "npx",
"args": ["@aiwerk/mcp-server-cal"],
"env": {
"CAL_API_KEY": "cal_live_your_api_key_here"
}
}
}
}Cursor
Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:
{
"mcpServers": {
"cal": {
"command": "npx",
"args": ["@aiwerk/mcp-server-cal"],
"env": {
"CAL_API_KEY": "cal_live_your_api_key_here"
}
}
}
}OpenClaw / Universal Recipe
{
"name": "cal",
"command": "npx",
"args": ["@aiwerk/mcp-server-cal"],
"env": {
"CAL_API_KEY": "${CAL_API_KEY}"
}
}Environment Variables
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Cal: common questions
- Is Cal MCP server safe?
- Mostly: it is graded B (75/100). Read the Cal safety report
- How do I install Cal?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Cal need an API key?
- Yes. The registry entry asks for
CAL_API_KEY. - Is Cal maintained?
- The last commit was 84 days ago (2026-08-10). The latest release is v1.0.6.
- How does Cal compare with other MCP servers?
- safety score 75/100 (higher than 45% of 48,273 servers); tools 12 (the typical server has 7); tools that change things 42% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.