Calcom MCP

What Danielpeter-99/calcom-mcp MCP server does

Danielpeter-99/calcom-mcp MCP server connects an LLM to a Cal.com account through the Cal.com API v2. Its tools cover account and scheduling data rather than general calendar providers or unrelated communication systems. The project is an independent implementation and is not affiliated with Cal.com.

Available operations include checking whether the API key is configured, retrieving event types, reading bookings, creating bookings, and listing schedules. It can also list teams, users, and configured webhooks for the authenticated account. These operations let an agent inspect scheduling resources and submit a booking with attendee information and event type identifiers.

How it works

The server is implemented with FastMCP and runs from the repository's app.py file. When started with the documented SSE transport, it listens on localhost port 8010. The server uses the Cal.com v2 base URL, authenticates requests with a Bearer token derived from CALCOM_API_KEY, and returns Cal.com responses as dictionaries or strings.

Booking queries support optional filters such as event type ID, user ID, status, start and end dates, and result limit. Schedule queries can be narrowed by user ID, team ID, and limit. Team, user, and webhook listing tools provide a limit option. Creating a booking requires values including the start time, attendee details, and event type identifiers; that operation also sends the documented Cal.com API version header for the endpoint.

Failures are returned as structured error information. Depending on the failure, the response can include an error type, HTTP status code, and response text. Consumers should check for an error key before processing returned data.

Setup and configuration

Danielpeter-99/calcom-mcp MCP server requires Python 3.8 or newer, a Cal.com account, and a Cal.com API v2 key. Clone or download the repository, create a virtual environment if desired, and install dependencies from requirements.txt.

Set CALCOM_API_KEY in the process environment before starting the server. On Linux or macOS, this can be exported from the shell; PowerShell users can set it through the environment syntax supported by Windows PowerShell. The key should not be placed directly in source code.

The README documents this launch command:

fastmcp run app.py --transport sse --port 8010

If the variable is absent, the server displays a warning and the tools return structured errors rather than authenticated Cal.com results.

Tools and capabilities

• Check API-key configuration with get_api_status.
• Retrieve all event types with list_event_types.
• Read bookings with optional event, user, status, date, and limit filters using get_bookings.
• Create a booking with create_booking.
• List schedules, optionally filtered by user or team.
• List teams, users, or webhooks, with optional result limits.

Danielpeter-99/calcom-mcp MCP server is therefore suited to agents that need Cal.com scheduling lookups and booking creation, provided the agent can access the locally running SSE service and the configured account has the necessary API permissions.