Credentials. The setup generates and stores ENCRYPTION_KEY_V1 and SIGNING_KEY as Cloudflare secrets, so keep them out of shared logs and chat transcripts.
Who it is forA solo consultant or small team lead who wants to stop paying per-seat for scheduling and already has a Cloudflare account.
The problemHosted scheduling tools charge for seats and gate features, and you do not control where booking data lives.
The outcomeA live Worker URL serving your booking pages, with D1, KV and R2 resources created in your own account.
What you need first
- Node 20+
- A Cloudflare account
- Command-line access to run wrangler
- Your own Google or Microsoft OAuth app, only if you want calendar sync
Steps
- Run
npx punctual-sh initif you have Node 20+ and a Cloudflare account; it clones the repo, creates resources, writes their ids into wrangler.toml, generates secrets, migrates and deploys. - Or clone by hand with
git clone https://github.com/CCCrafts/punctual.gitand thencd punctual && npm install. - Run
npx wrangler login, then create the D1, KV and R2 resources as described in the README and record their ids or names in wrangler.toml. - Generate and store the two secrets, ENCRYPTION_KEY_V1 and SIGNING_KEY, with
npx wrangler secret put. - Run
npm run migrate, thennpm run deploy, put the printed Worker URL into BASE_URL in wrangler.toml, and runnpm run deployagain.
Prompt for your agent
Using the CCCrafts/punctual repo, deploy the Worker to the Cloudflare account <account-name> following the README quick start. Report the final Worker URL and confirm that BASE_URL in wrangler.toml matches it.
Caveat. The README says the open-source version is complete for a single team, and the free-tier cost claim applies only to the Cloudflare resources you create.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for CCCrafts/punctual and "Host your own booking page on Cloudflare for free"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer