Cashflow

io.github.theluckystrikePublished by GitHub account theluckystrikev0.22.6Updated Oct 24, 2026

Bank CSV cashflow: categorise, summarise per currency, reconcile against expenses.

VerifiedSTDIODesktop onlyFiles & StorageFinanceData & Analytics

Overview

AI-generated overview

Turns a bank CSV export into a local ledger the assistant can import, categorise, summarise per currency, reconcile against receipts and export.

What you can do
  • Import bank CSV exports, auto-detecting header row, date, amount and currency columns, locale number formats and duplicates
  • List and search stored transactions by date range, account, category or text, with totals per currency
  • Set category rules and assign categories to transactions by id
  • Summarise money in, money out and net by category, month, account or counterparty, per currency
  • Detect recurring charges and subscriptions with cadence and annualised cost, and reconcile bank debits against expense-tracker receipts
  • Export a date range to CSV or JSON, and list imported accounts
When to use it
Useful for personal or small-business bookkeeping in chat: turning a monthly bank export into categorised totals, spotting subscriptions, and checking which debits lack receipts. It suits users who want the work done locally without an accounting SaaS subscription.
Requirements
Runs as a local process on the user's machine (desktop only). The npm package is described as not yet published, so the .mcpb bundle or a clone-and-build with Node.js is the working install path. An optional MCP_LICENSE_KEY enables Pro features; no account or network access is needed.
Before you install
It handles sensitive bank statement data, though the README states everything is stored in a local JSON file and no network calls are made. Import writes to that ledger, category rules re-apply to stored transactions, and export can overwrite an existing file. Pro features are a paid one-time license key; free tier limits accounts, history, rules and export.

Installation

In SourceWeft

  1. Open Cashflow in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mcp-bank-statement

In the official MCP Registry (io.github.theluckystrike/bank-statement-csv-categorize-reconcile-ledger).

[bank-statement demo]

Export the CSV from your bank, say "import this", and the month is readable. This MCP server turns a bank export into a local ledger: it finds the header row under whatever preamble the bank prints above it, works out which column is the date, which is the money and which way the money went, and reads amounts in the file's own locale, so 1 234,56 from mBank and 1,234.56 from a US bank both become the same number. A debit is stored negative and a credit positive, once, at import, so nothing downstream has to guess. Re-importing the same export adds nothing: every line carries a hash of its date, amount, currency and description, with an occurrence index, so two identical coffees on one day stay two transactions while a second import of the same file stays zero. Your rules categorise transactions as they arrive, summaries report money in, money out and the net per currency and never mix currencies, recurring_detect finds the subscriptions and what each costs per year, and reconcile_expenses matches bank debits against the receipts in mcp-expense-tracker so you can see which debits have no receipt and which receipts never reached the bank. Everything is a plain JSON file on your own machine; nothing is uploaded anywhere.

Turn a bank CSV into a categorised, reconciled month in chat, no accounting SaaS required.

Bank profiles: Revolut, Wise, mBank, PKO BP, ING, N26, and a generic reader that works from the headers alone.

File shapes it reads without being asked: UTF-8 and UTF-16 (either byte order, as Excel on Windows saves it), CRLF, LF and CR-only line endings, quoted fields holding commas, quotes and newlines, 1.234,56 and 1,234.56, accounting parentheses (12.50) and a trailing minus 12.50- (both negative), and a mixture of currencies inside one file. A cell holding - or nothing is skipped and named in skipped_lines rather than read as zero. When the date column is ambiguous (03/04/2026 with no value above 12 anywhere), the assumed order is stated in the response instead of silently picking one.

60-second install

npm publish for @theluckystrike/mcp-bank-statement is pending. Until then, the .mcpb one-click bundle or a clone+build is the working path, both are verified below.

One-click (.mcpb): download bank-statement.mcpb from the latest release and double-click it in Claude Desktop: https://github.com/theluckystrike/mcp-servers/releases/latest

(claude_desktop_config.json):

json
{  "mcpServers": {    "bank-statement": {      "command": "npx",      "args": ["-y", "@theluckystrike/mcp-bank-statement"]    }  }}

Claude Code:

sh
claude mcp add bank-statement -- npx -y @theluckystrike/mcp-bank-statement

(.cursor/mcp.json):

json
{  "mcpServers": {    "bank-statement": {      "command": "npx",      "args": ["-y", "@theluckystrike/mcp-bank-statement"]    }  }}

The npx form above starts working the moment the package is published. Until then, use the .mcpb bundle above, or build from source with exactly these three commands:

sh
git clone https://github.com/theluckystrike/mcp-servers.git && cd mcp-serversnpm installnpm run build -w packages/mcp-license -w servers/spreadsheet -w servers/bank-statement

Then point your client's command at node with one arg: the absolute path to servers/bank-statement/dist/index.js.

To run in Pro mode set MCP_LICENSE_KEY in the same config block, or call license_activate once with your key.

Tools

ToolWhat it does
statement_importRead a bank CSV into the ledger. Detects the header row under any preamble, the date, description, amount (or debit and credit) and currency columns, the date order and the number locale. Reports what it detected, what it stored, how many lines were duplicates of what is already there, and every line it skipped with the reason
transactions_listList transactions in a date range, filtered by account, category or uncategorized, with totals per currency
transactions_searchFind transactions whose description, counterparty, category or account contains the query. Substring only, never a regex
category_rulesSet or list the rules that categorise transactions. An empty match is refused, because it would stamp one category on the whole ledger. A plain match is a case-insensitive substring; regex: true compiles the pattern only if it cannot backtrack exponentially, and (a+)+ is refused and used as a substring. Setting rules re-applies them to stored transactions
transaction_categorizeSet the category on transactions by id. Nothing changes unless every id exists
statement_summaryMoney in, money out and the net for a range, grouped by category, month, account or counterparty, always per currency
reconcile_expensesMatch bank debits against the receipts in mcp-expense-tracker: same currency, same amount, within a date window. Reports matches, bank lines with no receipt, and receipts that never reached the bank. The expense ledger is only ever read
recurring_detectFind subscriptions and recurring charges: the same counterparty, an amount that barely moves, a steady cadence. Reports the cadence, the typical amount, the next expected date and the annualised cost. Two charges are one interval, so the yearly cost is withheld (cadence_confirmed: false) until a third charge confirms it
statement_exportWrite a range to csv or json and return the path. Written atomically, so a failure never leaves a half file. Replacing an existing file is allowed and reported (overwrote_existing_file)
accounts_listThe imported accounts, with bank, currencies, transaction count, date range and last balance
license_statusShow free or Pro mode
license_activateActivate a Pro key (verified offline)

Resource bank://month returns this month's money in, money out and net, grouped by category, per currency. Prompt monthly_review drives the whole month-end pass: totals, uncategorised lines, subscriptions, reconciliation.

Free vs Pro

FreePro
Accounts2unlimited
History read backlast 12 monthsall of it
Category rules5unlimited
Import, list, search, summariseyesyes
reconcile_expensesyes, 31 days at a timeany date range
recurring_detectyes, last 3 months, 5 chargesfull history, every charge
statement_exportnoyes

Import always stores every row, whatever the tier: silently dropping lines on the way in would make the ledger disagree with the bank. The free limit is on what is read back.

Get Pro: https://mcp.zovo.one/buy/bank-statement, $19 one-time for this server, $39 for every server, lifetime. Keys are verified offline; nothing is sent anywhere.

Pairs with

  • mcp-expense-tracker, log the receipts and the mileage; reconcile_expenses reads that ledger and tells you which bank debits have no receipt behind them.
  • mcp-spreadsheet, this server parses your bank CSV with the spreadsheet server's own RFC 4180 reader and locale number parser, so 1 234,56 means the same thing in both. Use it to slice an exported range.
  • mcp-invoice, the income side: raise the invoice, then watch the payment land in statement_summary grouped by counterparty.

Privacy

Everything stays on your machine. Statements are parsed locally and stored in a plain JSON file under ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/bank-statement/. The server makes no network calls at all, not for licensing, not for parsing, not for anything. Deleting that directory resets it.

Built by theluckystrike. Support: [email protected]

Use these docs as an MCP server

Any MCP client (Claude, Cursor, Windsurf, VS Code) can read this repository's documentation directly via GitMCP - no install:

Source: servers/bank-statement/README.md at commit 6535b33

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

3
  1. v0.22.6LatestOct 14, 2026
  2. v0.22.3Sep 23, 2026
  3. v0.21.0Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts