For the complete documentation index, see llms.txt. This page is also available as Markdown.

Developers

dCal is open source under the MIT license. Connect your own systems with API keys, the REST API, the Cal.com-compatible API and webhooks, or run your own copy of dCal on your own servers. An MCP serve

Everything else in these docs describes app.dcal.ai, the hosted dCal: free, nothing to install, signed in with your Dapta account. This section is for two other paths: connecting your own systems to dCal, and running your own copy.

dCal is open source under the MIT license. The full source lives at github.com/Dapta-Tech/dapta-calendars-slate, and you are free to read it, fork it, change it and run it.


What you can build

Goal
What to use
Read

Let another system check your open times and book, list, reschedule or cancel meetings

An API key and the REST API

Point a tool that already speaks Cal.com's API v2 at dCal

An API key and the /v2 endpoints

Let an AI assistant such as Claude, ChatGPT, Cursor, Claude Code or Codex find and hold times, book, move or cancel meetings, and answer booking requests for you

dCal's MCP server at https://mcp.dcal.ai/mcp, with a sign-in or an API key

Get told the moment a booking is created, rescheduled or cancelled

A webhook

Send every accepted booking to your CRM

The HubSpot integration, no code

Let a Text Agent or a Voice Agent book meetings for you

The scheduling action in the Dapta app, no code

Run dCal on your own servers

The repository

The pages for AI agents, API keys and webhooks sit in the left menu, and only workspace owners and admins see them:

In the left menu
What it holds

Connect your agent

The steps to connect Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw or Hermes by signing in with your account, one tab per app.

Tools

The 19 things a connected agent can do, in plain words, with an example request for each.

API and webhooks > API keys

Your API keys, and the agent skill for agents with no MCP.

API and webhooks > Webhooks

The messages dCal sends to your systems when a booking changes.

API and webhooks > API docs

Opens the API reference in a new tab, with a try-it console and a link to the OpenAPI document.

On Home, the banner and the Connect your agent card take you to the connect page.


What is in the repository

dCal is two applications plus a database:

  • The web app: the public booking pages, the page where guests manage their booking, and the whole dashboard.

  • The API: availability, bookings, the REST API and everything the dashboard saves.

The web app never reads the database directly: it calls the API over HTTP, so the two deploy and scale independently. Both ship as Docker images and run on any host that runs Node.

The repository also carries the guides you need, kept up to date with the code:

File
What it covers

The local quickstart: clone, install, run, with no database or accounts to set up.

The production guide: images, database, the full environment reference, reverse proxy, sign-in, email, calendar backend, upgrades and troubleshooting.

How the pieces fit and how requests flow.

Every setting with inline notes.

How to propose a change.

How to report a vulnerability privately.

💡 Tip: Contributions are welcome. Open pull requests against the develop branch, with a Conventional Commit title and a DCO sign-off on every commit (git commit -s). CI checks every pull request.


In this section

  • API keys: create a key, pick its scopes, store it safely and revoke it.

  • REST API: the endpoints, the headers, idempotency, errors, rate limits and the OpenAPI document.

  • Self-hosting: requirements, the database, the quickstart, sign-in, email and calendar options, and what changes when you leave app.dcal.ai.

  • Environment variables: every setting a self-hosted deployment reads, with its default.

  • Cal.com-compatible API: the /v2 endpoints for tools that already speak Cal.com's API.

  • Connect Claude or ChatGPT by signing in: connect Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw, Hermes or another app with your Dapta account, with no key.

  • Connect an AI assistant (MCP): the agent pages in dCal, the two ways to connect, connecting Cursor, Claude Code, Codex or another agent with a key, and the agent skill. The MCP server is available at https://mcp.dcal.ai/mcp.

  • MCP tools reference: the 19 tools the MCP server offers, with their inputs, answers, common flows, errors and rate limits.

Last updated