Cal.com API v2

REST discovered

Details

URL: https://api.cal.com/v2
Docs: https://cal.com/docs/api-reference/v2/introduction

Authentication

Cal.com API key bearer discovered Get token ↗

Authorization: Bearer <credential>

In the Cal.com app, go to Settings → Developer → API Keys and create an API key. Use it as Authorization: Bearer <apiKey>. Docs note test keys are prefixed cal_ and live keys cal_live_.

OAuth 2.0 oauth2 discovered

Authorization: Bearer <credential>

OAuth 2.0 — self-onboarding

Point your MCP client at the server URL and approve access in the browser. The server supports OAuth Dynamic Client Registration (RFC 7591), so the client registers itself automatically — no developer-portal app, client_id, or client_secret to create.

Cal.com platform OAuth client ID and secret x-cal-client-id: <credential> + Cal.com platform OAuth client ID and secret x-cal-secret-key: <credential> discovered

Cal.com platform OAuth client ID and secret compound Get key ↗

For existing Platform customers only, create an OAuth client first, then open the Platform settings to retrieve the platform client ID and secret. Cal.com documents sending them together as x-cal-client-id and x-cal-secret-key headers for deprecated platform endpoints.