DeepLedger
Menu

Reports & insights

Connect Claude to Stripe for Reporting: Payouts, Fees and Disputes

Give Claude read-only access to Stripe through DeepLedger: payouts, balance transactions, fees, refunds and disputes, next to the company's QuickBooks or Xero books.

Published by DeepLedger7 min read

Claude reads Stripe through DeepLedger's hosted MCP server, read only: you connect the company's Stripe account to DeepLedger once, add one custom connector in Claude, and Claude can answer questions about payouts, fees, refunds and disputes next to that company's QuickBooks Online or Xero books. Nothing Claude does through DeepLedger can refund, pay or change anything in Stripe.

This guide is for bookkeepers, accountants and finance teams who close the books for businesses that sell through Stripe. It covers what the connection reads, the setup in DeepLedger and Claude, and the questions that make a Stripe month-end quicker.

If you want to book a payout in the ledger, read the companion guide on reconciling Stripe payouts in QuickBooks or Xero after this one.

What you are connecting

DeepLedger connects Stripe for reporting, through Stripe's official MCP server, with DeepLedger's own rules in front of it. Claude sees one Stripe tool, and that tool only reads. Its operations are:

OperationWhat Claude gets
accountThe connected Stripe account, and whether it is live or a test account
balanceAvailable and pending balance
list_balance_transactions, get_balance_transactionThe bookkeeping feed: each charge, refund, fee, dispute and payout with its gross, fee and net, filterable by payout
list_payouts, get_payoutPayouts and their arrival dates
list_charges, list_refunds, list_disputesCharges, refunds and disputes
list_invoices, get_invoiceStripe invoices
list_application_fees, list_transfersApplication fees and transfers
list_customers, list_subscriptionsCustomers and subscriptions

Everything else Stripe's MCP server offers is blocked by DeepLedger: writes such as refunds, invoice and subscription changes, report runs, and any tool that moves money.

Two things are set by DeepLedger, not by Claude:

  • One account. Before each call DeepLedger reads which Stripe account the company's connection reaches and uses that account. If the grant reaches more than one account, DeepLedger refuses until you reconnect with one.
  • Live or test. The account's own mode is used as it is, so Claude cannot switch a live account into test mode or the other way round.

Stripe sits next to the company's books. The same DeepLedger connector gives Claude the ledger tools for the company's QuickBooks Online or Xero connection, so one conversation can read a payout in Stripe and look for its deposit in the ledger.

Before you start

  • A DeepLedger account. The trial needs no card.
  • The company in DeepLedger, usually with QuickBooks Online or Xero already connected.
  • Access to the Stripe account you want to connect, so you can approve it on Stripe's screen.
  • A Claude plan that allows custom connectors. Anthropic's custom connector guide covers the plans, with one custom connector on Free (as of November 2026).

See pricing for the Stripe add-on.

How do I connect Claude to Stripe?

  1. In DeepLedger, open Companies, select the company, open its Connections tab and select Connect Stripe on the Stripe (official MCP) card. Choose one Stripe account on Stripe's screen and approve.
  2. In Claude, open Customize → Connectors, select + Add, then Add custom connector.
  3. Name it DeepLedger and paste https://mcp.deepledger.ai/mcp. Select Continue.
  4. Keep Sign in now, choose Register automatically for the OAuth client, select Add, then sign in with your DeepLedger account and choose Allow.
  5. In a new chat, open + → Connectors and turn DeepLedger on.
  6. Ask Claude to confirm what it can see:

Using DeepLedger, which company am I in, and which Stripe account is connected? Is it live or a test account?

After step 1, the Stripe card shows Connected with the account name, and a Stripe sandbox badge if you connected a test account. If you already use DeepLedger in Claude for QuickBooks or Xero, skip steps 2 to 5: the same connector picks up Stripe once the company has it connected.

On Team and Enterprise plans, an owner adds the connector first under Organization settings → Connectors; members then connect with their own sign-in.

Claude Code: the same address works from the terminal with claude mcp add --transport http deepledger https://mcp.deepledger.ai/mcp, then /mcp to sign in. The Claude Code guide has the details.

What to ask Claude about Stripe

Name the company, the period and the currency. These are example prompts; check the first answers against the Stripe Dashboard.

Payouts for the month

List every Stripe payout that arrived in October 2026 with its arrival date and amount. Convert amounts from cents to dollars and give a total.

What made up one payout

For the payout that arrived on October 14, list its balance transactions: charges, refunds, fees and disputes, each with gross, fee and net. Show that the nets add up to the payout.

Fees for the period

Total the Stripe processing fees in balance transactions created in October 2026, by type. Do not include payouts.

Refunds and disputes

List refunds and disputes created in October 2026 with the charge they relate to and their status.

Compare with the ledger

Switch to Harbour Goods LLC. For each October Stripe payout, find the matching deposit in the books and list any payout with no deposit, or any deposit with no payout. Do not change anything.

Is it safe?

  • Read only by design. DeepLedger exposes only named read operations of Stripe's MCP server; Stripe's write tool, its report runs and every money tool are blocked.
  • One account, its own mode. DeepLedger chooses the Stripe account and its live or test mode, so a request cannot reach another account.
  • Team access. Each teammate signs in to DeepLedger as themselves. Members reach only the companies they are assigned to; owners and admins see every company.
  • Revoking access. Disconnect Stripe on the company's Connections tab, remove the connector in Claude, or revoke the grant under Settings → Connected apps in DeepLedger. Any one stops Claude reading Stripe.

Troubleshooting

What you seeWhat to do
Claude has no Stripe toolCheck that Stripe shows as connected on the company's Connections tab, and that Claude is working in that company.
"No active company"Ask Claude to list your companies, then switch to the one with Stripe connected.
The account is unclearThe Stripe grant reaches more than one account. Disconnect Stripe and connect again, choosing one account.
Amounts look 100 times too bigStripe returns amounts in the smallest currency unit. Ask Claude to convert and name the currency.
The Stripe card says Needs reconnectingConnect Stripe again on the company's Connections tab.

Frequently asked questions

How do I connect Claude to Stripe?

Connect Stripe to the company in DeepLedger once, on the company's Connections tab, and choose the Stripe account on Stripe's own screen. Then add https://mcp.deepledger.ai/mcp as a custom connector in Claude, sign in with your DeepLedger account, and ask Claude which Stripe account is connected.

Can Claude refund a payment or change anything in Stripe?

No. DeepLedger connects Stripe for reporting only. Its one Stripe tool reads the account, the balance, balance transactions, payouts, charges, refunds, disputes, invoices, application fees, transfers, customers and subscriptions. Refunds, invoice changes, subscription changes and every money movement are blocked, so you make those in Stripe yourself.

Why do Stripe amounts look 100 times too big?

Stripe returns amounts in the smallest unit of the currency, such as cents for US dollars. Ask Claude to convert to dollars and to name the currency in every table, and check one figure against the Stripe Dashboard.

Can one company connect more than one Stripe account?

No. The connection must reach exactly one Stripe account, and DeepLedger sets that account and its live or test mode on every call. If the grant reaches several accounts, DeepLedger refuses to read until you reconnect with one.

Do I need QuickBooks or Xero to use Stripe in DeepLedger?

Stripe is an add-on to a company in DeepLedger, and its job is to explain what Stripe paid out next to the company's books. Most firms connect it to a company that already has QuickBooks Online or Xero connected, so Claude can compare a payout with the deposit in the ledger.

See every supported app on AI platforms and integrations.

Ready to get started?

Connect QuickBooks and try your first task with an AI agent.

Create an Account

With your permission, Google Analytics measures visits to our public website and blog. Essential cookies work either way. Change your choice in Cookie settings. Privacy policy