The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Surfing Dog Inbox listing page.
An inbox for the bookings, orders, quote requests and messages that people and their AI agents send a business. Your rules answer the routine ones, and you see the rest. Open source, and you run it.
Add our demo bike shop to Claude or ChatGPT as a custom connector (an MCP server):
Then ask it: "Book a bike service with Oficina Maré on Saturday morning." Watch the booking arrive, and the shop confirm it, at https://demo.surfingdog.ai/demo/live. The demo never emails anyone who uses it, shows no names and is wiped every night.
The same with curl, step by step: https://surfingdog.ai/try/
Node 22.16+, 24 or 26. One process and one SQLite file.
Docker, built from this repository. The database lives in the volume.
Cloudflare Workers, with D1, a queue and a cron. Press Deploy to Cloudflare. What to have ready, and what to do after, is in the quickstart. By hand, it's path A of the install guide.
Or give your AI the install guide and let it do the work: it is written for that, with a check after every step.
/openapi.jsonapps/inbox: the server and the owner app, one codebase for Workers and Nodeapps/site: surfingdog.ai, with the docspackages/core: items, their states, rules and receiptspackages/adapters: REST, MCP, sign-in, email in, webhooks and networkspackages/platform: the database, mail and job seams for each runtimepackages/spec: the discovery manifest and receipt formats, with test vectorspackages/sdk: verify webhooks; sign requests and check receipts from a customer's agentpackages/ui: design tokens and componentsAGPL-3.0 for the server and the app. MIT for packages/spec and packages/sdk.