DoneOnce › Help › Your AI assistant in DoneOnce

Your AI assistant in DoneOnce

DoneOnce has an MCP server — the standard way an AI assistant (Claude, ChatGPT and others) plugs into an app. Once connected, you can ask your assistant things like "add the Garcias at 12 Oak St, biweekly on Tuesdays", "who is behind on payments?" or "send Ana the estimate for the pool cleaning", and it does the work inside your DoneOnce, as you.

It can do exactly what you can do in the app, and nothing more: a tech's assistant sees the day and the book, the office's sees the money. Anything that sends a message is described to you first and done only after your yes. Money never moves on an assistant's call: refunds, charges, payment reminders, connecting Stripe and your DoneOnce billing are done by you, in DoneOnce, on the Payments screen. Your assistant tells you so.

Start from your assistant

No DoneOnce account yet? Tell your assistant "set me up on DoneOnce". It shows you a link like https://app.doneonce.app/device?code=BCDF-GHJK and the code itself.

  1. Open the link and check that the page shows the same code your assistant shows.
  2. Press Create my business (or I already have an account and sign in). A new business confirms its email first; the link in that email brings you back to the same page.
  3. Read who is asking and press Approve. Then go back to your assistant: it sets up your zones, prices and clients with you, and shows you each step before it saves.

A code lasts 30 minutes and works once. If it runs out, ask your assistant for a new link — your account and your business are kept.

Connect Claude (claude.ai or the desktop app)

  1. In Claude, open Customize → Connectors, press + and choose Add custom connector.
  2. Name it DoneOnce and paste this URL: https://mcp.doneonce.app/mcp
  3. Press Add, then Connect. A DoneOnce window opens: sign in with your DoneOnce email and password, choose what it may do (Read only, the default, or Read and make changes) and press Approve.

That is all — no token to copy. Claude's Free plan allows one custom connector; paid plans more.

Connect Claude Code

In a terminal:

claude mcp add --transport http --scope user doneonce https://mcp.doneonce.app/mcp

Then type /mcp inside Claude Code, choose doneonce and sign in the same way.

Other assistants

Any assistant that supports remote MCP connectors with sign-in (OAuth) works with the same URL. A program that can only send a fixed header can use a token instead: in DoneOnce, Settings → Agents → How to connect → With a token, mint one, and send it as Authorization: Bearer <token>.

Staying in control

For the assistant reading this

Bringing a whole client list (for the assistant)

The person hands you their spreadsheet — an export from Jobber, Housecall Pro, QuickBooks, Excel or Google Sheets. Two tools, always in this order:

  1. import_book with the file as text, exactly as given, header row first. Never re-type, clean or summarize rows: the server reads the file with the same rules the app's Import CSV uses, and nothing is written yet. The separator may be a comma, a tab, a semicolon or a pipe (the header row decides), and a markdown table (| Name | Address | over a |---|---| row) is read as a table. The answer's hints warn about the file itself — a ZIP that lost its leading zero, a business with no zones — so relay them. Name the columns only if the guess in the answer is wrong (mapping: name, street, zip required; phone, email, category, day, frequency, notes, tech optional; null leaves one out). A column such as "Assigned to", "Team" or "Technician" is read as the tech: the person the old app had on the visit. If the whole address sits in one column ("12 Oak St, Stuart, FL 34994"), leave it: with no ZIP column the server reads each ZIP off the end of the address (zipFromAddress: true in the answer) and refuses, with its reason, a row that has none.
  2. Show the person the answer in plain words: how many become clients, how many get a weekly or every-other-week service and on which weekday (the zone that covers the ZIP decides it, then the file's day column), which rows are refused and why, which get no service and why, and the new categories. If a column was misread, fix mapping and preview again.
  3. commit_import with the importId, only after their yes. Call it again while remaining is above 0 — it continues where it stopped and never writes a row twice. Then report the totals: created, services, duplicates, failed (each failure comes with its reason).

What lands: each client with its address as the primary one (gate codes and notes on the address), its category, and its standing or one-time service, unplaced. Then two more tools, in this order:

  1. import_week (read-only) shows the week the import would build: for each weekday, who drives how many visits, the minutes and the revenue, and what cannot be placed yet and why. The zone that covers a ZIP decides the person and the weekday; with no zone, the person the file named (matched to the crew by name, or by first name when it is unique); with no name in the file and exactly one driver, that driver. A one-time visit goes on the day of its date; one dated beyond the coming 7 days is counted as laterOnce (still placed on its own date) and is not drawn in the week. A name the crew does not match comes back in unmatchedTechs: ask the owner who it is. With holdNamed: true the crew is never matched by name at all — every named visit waits for the owner's techMap answer. Use it when a name in the file could be mistaken for someone (an owner called "Carlos Pérez" and a tech the file calls "Carlos"), and pass the same flag to place_import.
  2. place_import, after their yes, puts that week on the routes. Call it again while done is false (it places up to 100 per call, and first locates any address still waiting), sending the answer's next as after — and no after when next is null, which means newly located addresses are walked again from the start. Pass the owner's answers as techMap ({"Johnny": "<crew member id>"}); a name left unmapped, a visit whose address could not be located (location_missing) and a one-time visit dated in the past stay unplaced and are listed. location_pending is different: the map has not found the address yet (it is slow or down), so say it is still being found and call again later. A service already on a route is never moved, and calling again places nothing twice.

place_queue and place_queue_apply remain for placing the standing queue by its zones outside an import (or the office does it from the week's queue in the app). Set the zones up before the import if the business has them, so the weekdays come out right.

When the client list is not a file

A list in prose, a photo of a page or an email is not a CSV yet — you make one, and the person approves it through the same preview:

Switching from Jobber or Housecall Pro: three files, in this order (for the assistant)

A business leaving another app exports three files. Bring them through the same two tools, one file at a time, always in this order:

  1. The client list — import_book as above (kind: "book", the default), then commit_import.
  2. The open quotes — import_book with kind: "quotes", then commit_import.
  3. The open balances (what each client still owes) — import_book with kind: "balances" and vendor ("Jobber", "Housecall Pro"), then commit_import.

The order matters because a quote or a balance never creates a client: each row must name a client the book already has — the same e-mail or phone and the same name, or the same name at the same address. A row naming anyone else is refused (quoteClientNotFound, balanceClientNotFound) and the answer's hints say to import the client list first. Always pass kind for these two files: with no kind the file is read as a client list, whatever its headers say. When a client-list preview's headers look like quotes or balances, the answer carries looksLike ("quotes" or "balances") and a hint — "This looks like a list of open balances; import it as balances?" — so ask the person and preview again with that kind. Nothing becomes a quote or a balance unless kind says so. A quotes or balances file over 1,000 rows is refused whole (split it, keeping each quote's lines in one file); it is never cut. A client list over 1,000 rows is cut, and its answer says truncated: true.

Quotes become estimates. An open, sent or awaiting-response quote becomes an estimate in the "sent, waiting for an answer" state, dated when it was sent — and nothing is sent to the customer: no e-mail, no text. The office can mark the yes, let it expire, or send the link later from the app. A draft stays a draft, and so does every quote whose status the file does not say — no status column, or an empty cell (quoteStatusUnknown): a quote is never assumed open. Approved, converted, declined, archived and expired quotes are history and are not imported (quoteClosed). The columns: the client's name, e-mail, phone and address, the quote number, a title or description, the total — or its line items (description, quantity, unit price; rows that share a quote number are one quote's lines) — the status, the date and the expiry. The lines are kept, and the total must equal them to the cent (quoteTotalMismatch otherwise): never adjust the file to make it fit — tell the person which quote disagrees. The quote number rides on the estimate. The answer's quotes says how many estimates, how many sent and how many drafts, and their total.

Balances become draft lines to bill. Each balance becomes one draft billable line on that client — "Opening balance carried over from Jobber on Nov 1, 2026" (in Spanish when the business's language is Spanish) — that the office approves and invoices on the Billing screen. No invoice is created and nothing is charged by the import. Zero or a credit balance is not imported (balanceNotOwed). The columns: the client's name, e-mail, phone and address, the amount owed, the "as of" date, and an invoice number or note. A client has one opening balance: rows with an invoice number are a line each, and a client's rows without one are added into one line (balanceSummed says which). A client whose rows mix invoice numbers and a bare total — an aged-receivables export that lists both — gets none of them (balanceMixedRows, with both sums): the person keeps one or the other. A client who already has an opening balance from an earlier import, in any state, is refused (balanceAlreadyImported, with that amount): a re-export after a partial payment is never billed twice, so change that line on Billing instead. Importing balances needs the owner (admin) or a manager in the billing department; importing quotes, the owner or a manager in the sales department (the import itself is the office's: admin or manager).

The same file twice adds nothing: a quote or a balance already imported is counted as a duplicate.

Updated 2026-11-15

14 days free, no card. Setup is done with you, in English or Spanish.

Start free