Cal.com

Lightweight, dependency-free, in-memory Cal.com API v2 (and v1-style) fake for testing scheduling code.

Default port: 4849

Quick start

import { CalComServer } from "./services/cal-com/src/server.js";

const server = new CalComServer(4849);
await server.start();
// ... run your app/tests ...
await server.stop();

Point a Cal.com client at http://127.0.0.1:4849. Authenticate with a Bearer cal_... API key, or ?apiKey= for the v1-style flow (any non-empty key accepted):

const res = await fetch("http://127.0.0.1:4849/v2/me", {
  headers: { Authorization: "Bearer cal_parlel" },
});
const { status, data } = await res.json();

Response shape

v2 responses use:

{ "status": "success", "data": ... }

Implemented operations

/v2/* and /v1/* routes require auth. State is in-memory.

• GET /v2/me — the authenticated user.
• GET /v2/event-types — list event types (data.eventTypes and data.eventTypeGroups).
• GET /v2/slots — available slots keyed by day (?eventTypeId=&start=&end=).
• GET /v2/bookings — list bookings.
• POST /v2/bookings — create a booking (201).
• GET /v2/bookings/:uid — retrieve a booking.
• PATCH /v2/bookings/:uid — reschedule (update start/end).
• POST /v2/bookings/:uid/cancel — cancel a booking (status: "cancelled").

The same routes are reachable under /v1/... for v1-style clients using ?apiKey=.

Service & inspection (parlel extensions)

• GET / — service metadata.
• GET /health — health check.
• POST /__parlel/reset — reset state.
• OPTIONS * — CORS preflight (204).

Access via MCP / preview URL

The emulator is reachable at CAL_COM_BASE_URL (http://127.0.0.1:4849). When running in the parlel pool, an MCP tool / preview URL proxies to this base URL — point your Cal.com client at that URL with a Bearer cal_ key (or ?apiKey=) and every endpoint above works as documented.

Surface coverage

This emulator faithfully replicates the API surface most application code and agents exercise. Anything below the supported lines is either an intentional design choice for a fast, zero-cost local emulator (✓ By design) or a candidate for a future release (⟳ Roadmap) — never a silent inaccuracy.

Legend: ✅ fully supported · ◐ accepted (stored, not strictly enforced) · ✓ by design · ⟳ on the roadmap.

Error codes & shapes

Errors use { status: "error", error: { code, message } }:

Manifest

See services/cal-com/manifest.json:

• name: cal-com, port: 4849, protocol: http, healthcheck: /health, startup ≈ 100ms
• env: CAL_COM_API_KEY, CAL_COM_BASE_URL

Configuration — test.env

Copy these into your test.env (used by the bridge sidecar flow). Tokens are Parlel's seeded test credentials — any non-empty value is accepted by the emulator, so you rarely need to change them. Swap in real credentials only when pointing at the live service in prod.env.

CAL_COM_API_KEY=cal_parlel
CAL_COM_BASE_URL=http://parlel-bridge:4849