AggregateDocs
aggregate.financeSign in
Connect your AI

Connect BILL to Claude

Last updated

Short answer: connect BILL to Aggregate, then add Aggregate to Claude with one link (https://app.aggregate.finance/mcp). Claude can then answer questions about the bills you owe, the invoices you've sent, and the payments made and received against them, using one ledger that also holds your other accounts and companies. Aggregate only reads from BILL, it can never move money, and you choose exactly what Claude can see.

Status: Live on the hosted version. You connect with a BILL sync token you make in your own BILL account, not a sign-in window.

Set it up

1. Connect BILL to Aggregate

Sign up at app.aggregate.finance (free during beta). In BILL, open Settings → Sync & Integrations → Tokens, choose New, give the token a name (for example aggregate) and save. Then in Aggregate open Workspace → Connections → + More connections → BILL and paste the sync token's name, the sync token, and your BILL organization ID.

2. Add Aggregate to Claude

  1. In Claude (claude.ai or Claude Desktop), open Customize → Connectors (in some accounts still Settings → Connectors), choose Add, then Add custom connector.
  2. Name it Aggregate, paste https://app.aggregate.finance/mcp and click Continue. Claude detects the sign-in; click Add, then Connect.
  3. Sign in to Aggregate and choose what Claude can see: which companies, which kinds of data, read only or read and add, and when access expires.
  4. In a new chat, turn on the Aggregate connector and ask a question.

Using Claude Code instead? Run claude mcp add --transport http --scope user aggregate https://app.aggregate.finance/mcp, then /mcp to sign in.

Five questions to try

  1. "What bills are due in the next 14 days?" (uses list_upcoming)
  2. "Who owes us the most, and how overdue is it?" (uses query_invoices)
  3. "How much do we owe vendors right now, grouped by how overdue it is?" (uses query_invoices)
  4. "Which unpaid invoices are over $1,000?" (uses search_invoices)
  5. "How fast does Acme Corp usually pay us?" (uses get_counterparty)

Claude answers from Aggregate's ledger, where a payout and the bank deposit it becomes are matched, not added twice (a pair it isn't sure of waits in Review for you), and balances are checked against the source. Each answer can be traced to the records behind it.

Questions people ask

Does Aggregate see my password? No. You never give Aggregate your BILL password: you paste a sync token you made in BILL, and you can archive it there at any time. Aggregate stores the token encrypted with a key kept outside the database.

Does my data train AI models? Aggregate never uses your data to train models and doesn't let anyone else. What Claude reads is covered by Anthropic's own data policy for your plan.

Can Claude move money or change my BILL? No. Aggregate has no tool that pays, transfers, pays a bill or sends anything, and it only reads from BILL. (BILL offers no read-only token: a sync token can edit records in your BILL account, but can't pay anyone or move money. Aggregate's BILL connector only makes read requests after signing in.) If you allow it, Claude can add records inside Aggregate (for example a cash expense), and those can be undone for 30 days.

What does it cost? The hosted version is free while we're in beta. We may introduce paid plans later, and we'll let you know before anything changes. Self-hosting is free (AGPL-3.0).

Can I run it myself? Yes. Aggregate is open source; see self-hosting. You'll need your own BILL developer key and a BILL user login.

Last checked 2026-11-03.

© 2026 Aggregate Finance LLC