drafty
QuickBooks logo

Build a QuickBooks P&L and cashflow dashboard with Claude

Connect the QuickBooks Online MCP server to Claude, ask for a profit & loss and cashflow dashboard from your live books, and publish it to a link your finance team comments on directly — no spreadsheet export, no screenshots pasted into Slack.

What you'll build
A self-contained finance dashboard — net income as the hero number, revenue vs. expenses, a P&L breakdown by category, cash in vs. out, and a closing cash position — generated by Claude from your real QuickBooks data, then published to a drafty.im/canvas/… link. Your team clicks the exact line item or number they want changed and leaves a note. Claude reads the comments and ships a revised version to the same URL.

This is an end-to-end example: connect a data source over MCP, generate a dashboard from live numbers, and close the review loop on one link. Total time, start to shared link, is under fifteen minutes. The same shape works for any of the other examples — only the connection step changes.

Here's the finished dashboard, published to a canvas — click any tile or number to leave a comment, exactly as your team would:

Live canvas — comment on any elementOpen ↗

The three moving parts

  1. The QuickBooks Online MCP server gives Claude read access to your books — profit & loss, balance sheet, cash flow, customers, invoices — through a controlled set of tools. You authorize the company and choose what it can touch.
  2. Claude pulls the numbers and writes a single self-contained HTML dashboard. You iterate on it in the artifact panel until it's right.
  3. Drafty turns that HTML into a stable link your team reviews. Comments pin to the exact element; Claude ships the fix to the same URL.

The generation step is fast now. The part this example is really about is the third one — getting the dashboard in front of people without losing their feedback to a screenshot circled in Preview.

Step 1 — Connect the QuickBooks MCP server

Intuit ships an official QuickBooks Online MCP server. It runs locally as a stdio process, so you clone it, build it, and authorize your company once over OAuth — the tokens land in a local .env, never in a chat.

Set it up:

claude
git clone https://github.com/intuit/quickbooks-online-mcp-server.git && cd quickbooks-online-mcp-server && npm install && npm run build

Then run the OAuth handshake — it opens your browser to sign in and authorize the company, and saves the refresh token and realm id to .env:

claude
npm run auth

In Claude Code: add the built server, passing your QuickBooks credentials and the read-only flag so it can never write to your books:

claude
claude mcp add quickbooks --env QUICKBOOKS_CLIENT_ID=your_client_id --env QUICKBOOKS_CLIENT_SECRET=your_client_secret --env QUICKBOOKS_REFRESH_TOKEN=your_refresh_token --env QUICKBOOKS_REALM_ID=your_realm_id --env QUICKBOOKS_ENVIRONMENT=production --env QUICKBOOKS_DISABLE_WRITE=true -- node ./dist/index.js

In Claude Desktop: open Settings → Developer → Edit Config and add a quickbooks entry under mcpServers with command: "node", args: ["path/to/dist/index.js"], and the same env block — including QUICKBOOKS_DISABLE_WRITE: "true".

Safety first
Set QUICKBOOKS_DISABLE_WRITE=true (and you can add QUICKBOOKS_DISABLE_UPDATE=true / QUICKBOOKS_DISABLE_DELETE=true) so the server exposes read tools only — a reporting dashboard never needs to change your books. Keep the client secret and refresh token in the local .env; never paste them into a chat or commit them to a repo.

Step 2 — Pull the numbers

Ask Claude in plain language. It uses the MCP server's report tools (get_profit_and_loss, get_cash_flow, get_balance_sheet) to fetch real data:

claude
Using the QuickBooks MCP server, pull everything we need for a finance dashboard for this month to date: the profit & loss report (total income, total expenses, net income, and the top expense categories), the cash flow report (cash in, cash out, net change, and closing cash position), and the same figures for the prior month so we can show month-over-month change. Summarize the figures before you build anything.

Claude calls QuickBooks, returns the figures, and you sanity-check them against the QuickBooks reports before going further. This is the moment to catch a wrong assumption — a cash vs. accrual basis you didn't expect, a date range off by a month, an uncategorized account skewing a total — while it's cheap.

Step 3 — Build the dashboard

Once the numbers look right, ask for the artifact:

claude
Build a single self-contained HTML dashboard from those figures. Net income as the hero number with month-over-month change, then tiles for total income, total expenses, and net cash change. A revenue-vs-expenses bar for this month vs. last, a P&L breakdown of the top expense categories, and a small cash-position summary. Clean, no external dependencies — inline the CSS and any chart code.

Claude renders it live in the artifact panel. Iterate in place — you're not regenerating from scratch:

Step 4 — Publish to Drafty for review

A Claude artifact link is a preview, not a stable URL — iterate the artifact and the link you already sent now shows the old version. Ask Claude to publish it to a Drafty canvas instead, so the link you share always stays current:

claude
Publish this dashboard to Drafty as a canvas and give me the shareable link.

Claude pushes the dashboard and hands back a drafty.im/canvas/… link that renders on any device. Send it — your team opens it in a browser, no login and no Claude account needed.

Step 5 — The review loop

This is the part that's not obvious until you've done it once.

A reviewer clicks the specific tile, line item, or number they want changed and leaves a pinned comment — "this expense total looks high, are we including the annual software renewal that should be amortized?" The comment is anchored to that element, not floating in a Slack thread. Claude reads the comments through the CLI, reruns the relevant QuickBooks query if needed, and pushes a revised dashboard to the same URL. The reviewer refreshes and sees the change; the thread stays attached to the element.

The mechanic matters because of what it removes. A Slack message about a chart produces "the number on the left looks wrong." A pinned comment on the actual tile produces "this — split out the one-time equipment purchase from operating expenses." One of those produces a correct revision; the other produces a guess.

Keeping it fresh

An MCP-generated dashboard is a snapshot — it holds the numbers Claude pulled when it built it; it doesn't re-query QuickBooks when someone opens the link. For a monthly close or a board-ready snapshot, that's fine.

To make it a live canvas that always shows today's figures, copy this prompt — Claude sets up the refresh for you and schedules it to run on its own:

claude
Turn this QuickBooks dashboard into a live canvas: every morning, re-pull the latest P&L and cash flow numbers from QuickBooks via the MCP server, rebuild the dashboard, and push a new version to the same canvas URL so the link always shows today's figures. Schedule it to run daily on its own.

The link stays stable while the content updates underneath it — see keeping a canvas updated automatically.

What to watch for

QuickBooks dashboard with Claude — FAQ

Do I need to paste my QuickBooks credentials into the chat?
No. The QuickBooks MCP server runs locally and reads its client id, secret, refresh token, and realm id from environment variables you set when adding the server. The `npm run auth` step does the OAuth handshake in your browser and writes the tokens to a local `.env` — nothing sensitive goes into a chat, and nothing should be committed to a repo.
Is the dashboard live or a snapshot?
A snapshot. It contains the numbers Claude pulled when it built the file; it does not re-query QuickBooks when someone opens the link. To refresh it, ask Claude to repull and re-push to the same URL — or put that on a daily schedule so the stable link always shows current numbers.
Can my team comment without a QuickBooks or Claude account?
Yes. The dashboard is published to a Drafty canvas link that renders in any browser. Reviewers click the exact element they want changed and leave a pinned comment with no login required. Only the person connecting QuickBooks needs access to the books.
Is it safe to give Claude access to my QuickBooks books?
Run the server with QUICKBOOKS_DISABLE_WRITE=true so it exposes read tools only, and a P&L and cashflow dashboard never needs more than that. The server runs locally, every tool call is mediated by it, and in Claude you approve actions. Don't enable write tools for a read-only reporting task.
How is this different from QuickBooks' own reports or a BI tool?
QuickBooks reports and BI tools query live data against a model you maintain — the right choice for governed reporting and the official source of truth at close. This approach is for a fast, shareable snapshot you can spin up in minutes and iterate by talking to Claude, then collect feedback on inline. Different jobs: one is a standing system, the other is a quick reviewable deliverable.