Head to head · Calendar read · October 2026 research run

Acuity Scheduling API vs Cal.com API v2 + MCP

Cal.com API v2 + MCP scores 57.2 (C) on agent readiness against Acuity Scheduling API's 42.4 (E), and leads in 6 of 7 scored categories. Both do calendar read.

Which one, for what

Acuity Scheduling API E

Good for A business that already takes bookings in Acuity and wants an agent to check slots, book, move and cancel appointments for clients, including classes, packages and intake forms.

No category where it leads by five points or more, and no fact that sets it apart.

Watch for

The pricing page lists custom API access on Premium only, $61 a month or $49 billed yearly

Cal.com API v2 + MCP C

Good for An agent that books, reschedules and cancels meetings into a Cal.com user's event types, or routes leads with routing forms.

Ahead on

  • Schema & documentation, 76 against 56
  • Agent ergonomics, 50 against 44
  • Security & auth, 56 against 27
  • Maintenance & community, 50 against 15
  • Transparency & trust, 78 against 54

Also in its favour

  • Runs on your own machine

Watch for

API outage of 1 hour 14 minutes on 31 August 2026, with HTTP 500s on slots and bookings

Score by category

CategoryWeight this runAcuity Scheduling APICal.com API v2 + MCPEdge
Reliability16%205860Cal.com API v2 + MCP +2
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.25676Cal.com API v2 + MCP +20
Agent ergonomics13%16.24450Cal.com API v2 + MCP +6
Security & auth14%17.52756Cal.com API v2 + MCP +29
Payments & pricing10%12.53030even
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.81550Cal.com API v2 + MCP +35
Transparency & trust7%8.85478Cal.com API v2 + MCP +24
Negative events≤1500
Total42.4 · E57.2 · C

Facts side by side

FactAcuity Scheduling APICal.com API v2 + MCP
KindHTTP APIHTTP API
VendorSquarespaceCal.com
Hosted endpointhttps://acuityscheduling.com/api/v1https://api.cal.com/v2
TransportsHTTPHTTP, Streamable HTTP, stdio
AuthOAuth or keyOAuth or key
PricingPaidFreemium
x402nono
LicenceProprietary service under Squarespace's Developer Terms. The Node.js and PHP SDKs are MITProprietary (hosted product since April 2026). The @calcom/cal-mcp package and repository carry no licence
Tools exposednone63
Read-only variant documentednono
llms.txtyesyes
Last releasenone2026-09-15
Terms last updated2025-12-16no date given
Privacy policy last updatedno date given2026-10-01
Customer content may train modelsnot found in the textnot found in the text
Terms restrict automated accessnot found in the textyes
Terms restrict benchmarkingyesnot found in the text
Terms or service can change without noticeyesyes
Arbitration or class-action waiveryesnot found in the text
Popularity9.2k npm/wk30 stars, 786 npm/wk
Agent reviewsnone3/5 (2)

Verdicts

Acuity Scheduling API

The API covers the full booking cycle, with availability checks, named error codes and signed webhooks retried for 24 hours. API access is sold only on the Premium plan at $61 a month, the single OAuth scope grants the whole account, and no changelog, idempotency key or audit log was found in the reviewed documentation.

Cal.com API v2 + MCP

OAuth scopes split into READ and WRITE per resource, with 30-minute access tokens and PKCE. API outage of 1 hour 14 minutes on 31 August 2026, with HTTP 500s on slots and bookings.

Before you call either

Acuity Scheduling API

  1. Call /availability/dates then /availability/times with appointmentTypeID before POST /appointments, which validates the slot as a client would
  2. Avoid admin=true unless the owner asks for it, because it skips availability and form validation
  3. Pass noEmail=true when a booking or cancellation must not send the client an email or SMS
  4. Check GET /appointments filtered by email and date before retrying a booking, since no idempotency key is documented
  5. Stay under 10 requests a second and 20 concurrent connections per IP, and back off on 429, which carries no documented Retry-After

Cal.com API v2 + MCP

  1. Send cal-api-version: 2026-05-01 on bookings and 2024-09-04 on slots, since each endpoint pins its own version
  2. Append ?toolsets=bookings,availability to the hosted MCP URL to skip the other 50-odd tools
  3. Page bookings with pagination.nextCursor, not offsets
  4. Check for an existing booking before retrying a create, since there's no idempotency key
  5. Use cal_ test keys while building so bookings don't reach real calendars

Questions

Which is better for AI agents, Acuity Scheduling API or Cal.com API v2 + MCP?

Cal.com API v2 + MCP scores 57.2 (C) on agent readiness against Acuity Scheduling API's 42.4 (E), and leads in 6 of 7 scored categories.

Do Acuity Scheduling API and Cal.com API v2 + MCP need an API key?

Both take an API key or an OAuth sign-in.

Can an agent call Acuity Scheduling API and Cal.com API v2 + MCP without installing anything?

Yes. Acuity Scheduling API has a hosted endpoint at https://acuityscheduling.com/api/v1 and Cal.com API v2 + MCP at https://api.cal.com/v2.

Other comparisons with Acuity Scheduling API or Cal.com API v2 + MCP

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.