drafty
Brex logo

Build a Brex spend dashboard with Claude

Connect the Brex MCP server to Claude, ask for a card-spend and budgets dashboard from your live numbers, and publish it to a link your team comments on directly — no BI tool, no screenshots pasted into Slack.

What you'll build
A self-contained spend dashboard — total card spend this month, spend by department, budget utilization with how much room is left, top merchants, and recent card transactions — generated by Claude from your real Brex data, then published to a drafty.im/canvas/… link. Your team clicks the exact budget bar 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 Brex MCP server gives Claude read access to your Brex account — card spend, expenses, budgets and spend limits, banking transactions, vendors — through a controlled set of tools. You approve 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 finance and budget owners without losing their feedback to a screenshot circled in Preview.

Step 1 — Connect the Brex MCP server

Brex runs an official remote MCP server at https://api.brex.com/mcp. First, an account or card admin enables it once in the Brex dashboard: Settings → Early access → turn on "Brex in AI assistants", and accept the Developer API agreement under Settings → Developer. Then you connect from Claude; it authenticates over OAuth, so no key is pasted into a config file.

In Claude Code:

claude
claude mcp add --transport http brex https://api.brex.com/mcp

Then run /mcp inside Claude Code and follow the OAuth prompt to authorize your Brex account. The MCP server requests exactly the scopes its tools need and you approve them on the consent screen — grant read access only, since this dashboard never writes to Brex.

In Claude Desktop: open Settings → Connectors → Add custom connector, paste https://api.brex.com/mcp, and authorize with OAuth the same way.

Safety first
Use OAuth and approve read scopes only, or — if you're running an unattended agent — a Brex API token (Settings → Developer) provisioned with read scopes for just the resources you need. The MCP server respects the scopes on the token. Never paste a token into a config file or commit it. The dashboard only reads; it has no reason to hold write permissions.

Step 2 — Pull the numbers

Ask Claude in plain language. It uses the Brex MCP server's read tools to fetch real data:

claude
Using the Brex MCP server, pull everything we need for a spend dashboard: total card spend this month vs. last month, spend broken down by department, each budget's limit and how much has been used, the top 8 merchants by spend in the last 30 days, and the 10 most recent card transactions. Summarize the figures before you build anything.

Claude calls Brex, returns the figures, and you sanity-check them against the Brex dashboard before going further. This is the moment to catch a wrong assumption — a partial billing period, pending versus settled transactions, a budget that resets mid-month — 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. Total card spend this month as the hero number with month-over-month change, then a budget-utilization section showing each budget's bar with amount used and remaining, spend by department, and a recent-transactions table at the bottom. 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 budget bar, department, or number they want changed and leaves a pinned comment — "this engineering budget looks over, are we counting pending transactions?" The comment is anchored to that element, not floating in a Slack thread. Claude reads the comments through the CLI, reruns the relevant Brex 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 — exclude pending transactions from the budget total." 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 Brex when someone opens the link. For a weekly spend review 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 Brex dashboard into a live canvas: every morning, re-pull the latest card spend and budget figures from Brex via the MCP server, rebuild the dashboard, and push a new version to the same canvas URL so the link always shows today's numbers. 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

Brex dashboard with Claude — FAQ

Do I need to paste my Brex API token anywhere?
No. The remote Brex MCP server at api.brex.com/mcp authenticates over OAuth, so you authorize the account through a consent screen instead of pasting a token. For an unattended agent, use a Brex API token from Settings → Developer provisioned with read scopes — never broader than the workflow needs, and never 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 Brex 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 spend.
Can my team comment without a Brex 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 Brex needs access to the account.
Is it safe to give Claude access to my Brex account?
Connect with read-only OAuth scopes or a read-scoped API token, and a spend dashboard never needs more than that. An admin enables the MCP server in the Brex dashboard first, every tool call is mediated by the MCP server, and in Claude you approve actions. Don't grant write scopes for a read-only reporting task.
How is this different from Brex's built-in spend reporting?
Brex's native reports and exports query live data inside Brex — the right choice for governed, recurring reporting. 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.