Cal.com API

Cal.com's open-source scheduling API for managing availability, event types, bookings, and calendar integrations — available as cloud or self-hosted.

Evaluated Mar 06, 2026 (0d ago) vcurrent
Homepage ↗ Repo ↗ Other calcom scheduling booking calendar open-source self-hosted rest-api sdk
⚙ Agent Friendliness
56
/ 100
Can an agent use this?
🔒 Security
83
/ 100
Is it safe for agents?
⚡ Reliability
77
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
--
Documentation
75
Error Messages
70
Auth Simplicity
80
Rate Limits
72

🔒 Security

TLS Enforcement
100
Auth Strength
80
Scope Granularity
75
Dep. Hygiene
80
Secret Handling
78

Open-source scheduling platform. API key auth. Meeting attendee data is PII. Self-hostable for full privacy control. OAuth2 for user-scoped access.

⚡ Reliability

Uptime/SLA
80
Version Stability
78
Breaking Changes
75
Error Recovery
75
AF Security Reliability

Best When

An agent needs full API control over scheduling including creating event types, or when self-hosting is required for data privacy.

Avoid When

You need a no-code scheduling solution or are looking for Calendly's specific integrations.

Use Cases

  • Creating and managing event types and booking pages programmatically
  • Reading and managing bookings for automated workflows
  • Setting availability schedules for teams and individuals
  • Building custom scheduling interfaces with full API control
  • Self-hosted scheduling with data residency requirements

Not For

  • Teams needing Calendly's polished UI without development effort
  • Very simple one-person scheduling without API needs
  • Teams without technical resources for self-hosting (use cloud instead)

Interface

REST API
Yes
GraphQL
No
gRPC
No
MCP Server
No
SDK
Yes
Webhooks
Yes

Authentication

Methods: api_key oauth2
OAuth: Yes Scopes: Yes

API keys for personal access (v1). OAuth2 for platform integrations (v2). v2 API uses OAuth tokens. Both versions coexist — verify which version is needed.

Pricing

Model: freemium
Free tier: Yes
Requires CC: No

Free cloud tier is very generous. Self-hosting is completely free. API access on all tiers. Much better free tier than Calendly for API users.

Agent Metadata

Pagination
page
Idempotent
No
Retry Guidance
Not documented

Known Gotchas

  • Two API versions (v1, v2) with different auth and capabilities — documentation can be confusing
  • Self-hosted deployments require maintaining your own infrastructure and SSL
  • Webhook events have evolved between versions — check event types carefully
  • Rate limits not publicly documented — agents may hit undocumented limits
  • Calendar integration (Google, Outlook) must be set up by end user, not API
  • Booking reschedule logic requires creating new booking then canceling old one

Alternatives

Full Evaluation Report

Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for Cal.com API.

$99

Scores are editorial opinions as of 2026-03-06.

5173
Packages Evaluated
26151
Need Evaluation
173
Need Re-evaluation
Community Powered