> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dcal/developers.md).

# 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](https://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](https://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                                                  | [API keys](https://docs.dapta.ai/dcal/developers/api-keys.md), [REST API](https://docs.dapta.ai/dcal/developers/rest-api.md)                                                                                                                                              |
| Point a tool that already speaks Cal.com's API v2 at dCal                                                                                                         | An API key and the `/v2` endpoints                                           | [Cal.com-compatible API](https://docs.dapta.ai/dcal/developers/cal-com-compatible-api.md)                                                                                                                                                                                 |
| 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 | [Connect an AI assistant (MCP)](https://docs.dapta.ai/dcal/developers/mcp-server.md), [Connect Claude or ChatGPT by signing in](https://docs.dapta.ai/dcal/developers/connect-with-sign-in.md), [MCP tools reference](https://docs.dapta.ai/dcal/developers/mcp-tools.md) |
| Get told the moment a booking is created, rescheduled or cancelled                                                                                                | A webhook                                                                    | [Webhooks](https://docs.dapta.ai/dcal/integrations/webhooks.md)                                                                                                                                                                                                           |
| Send every accepted booking to your CRM                                                                                                                           | The HubSpot integration, no code                                             | [HubSpot](https://docs.dapta.ai/dcal/integrations/hubspot.md)                                                                                                                                                                                                             |
| Let a Text Agent or a Voice Agent book meetings for you                                                                                                           | The scheduling action in the Dapta app, no code                              | [Let your Dapta agent book](https://docs.dapta.ai/dcal/dapta-agents.md)                                                                                                                                                                                                   |
| Run dCal on your own servers                                                                                                                                      | The repository                                                               | [Self-hosting](https://docs.dapta.ai/dcal/developers/self-hosting.md), [Environment variables](https://docs.dapta.ai/dcal/developers/environment-variables.md)                                                                                                            |

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                                                                                                                                         |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [`README.md`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/README.md)             | The local quickstart: clone, install, run, with no database or accounts to set up.                                                                     |
| [`SELF-HOSTING.md`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/SELF-HOSTING.md) | The production guide: images, database, the full environment reference, reverse proxy, sign-in, email, calendar backend, upgrades and troubleshooting. |
| [`ARCHITECTURE.md`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/ARCHITECTURE.md) | How the pieces fit and how requests flow.                                                                                                              |
| [`.env.example`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/.env.example)       | Every setting with inline notes.                                                                                                                       |
| [`CONTRIBUTING.md`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/CONTRIBUTING.md) | How to propose a change.                                                                                                                               |
| [`SECURITY.md`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/SECURITY.md)         | 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](https://docs.dapta.ai/dcal/developers/api-keys.md): create a key, pick its scopes, store it safely and revoke it.
* [REST API](https://docs.dapta.ai/dcal/developers/rest-api.md): the endpoints, the headers, idempotency, errors, rate limits and the OpenAPI document.
* [Self-hosting](https://docs.dapta.ai/dcal/developers/self-hosting.md): requirements, the database, the quickstart, sign-in, email and calendar options, and what changes when you leave app.dcal.ai.
* [Environment variables](https://docs.dapta.ai/dcal/developers/environment-variables.md): every setting a self-hosted deployment reads, with its default.
* [Cal.com-compatible API](https://docs.dapta.ai/dcal/developers/cal-com-compatible-api.md): the `/v2` endpoints for tools that already speak Cal.com's API.
* [Connect Claude or ChatGPT by signing in](https://docs.dapta.ai/dcal/developers/connect-with-sign-in.md): connect Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw, Hermes or another app with your Dapta account, with no key.
* [Connect an AI assistant (MCP)](https://docs.dapta.ai/dcal/developers/mcp-server.md): 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](https://docs.dapta.ai/dcal/developers/mcp-tools.md): the 33 tools the MCP server offers, with their inputs, answers, common flows, errors and rate limits.

## Related

* [Webhooks](https://docs.dapta.ai/dcal/integrations/webhooks.md): get every booking change pushed to your endpoint.
* [Let your Dapta agent book](https://docs.dapta.ai/dcal/dapta-agents.md): the no-code way to let an AI agent book on dCal.
* [Security and privacy](https://docs.dapta.ai/dcal/security-and-privacy.md): what dCal stores, how keys and links are protected, and how to report a vulnerability.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dcal/developers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
