bank-statement-csv-categorize-reconcile-ledger
io.github.theluckystrike/bank-statement-csv-categorize-reconcile-ledger·v0.22.0Import a bank CSV, categorise it, summarise it per currency and reconcile it against your expenses.
Tools (15, 2 write)
write = sends, deletes, buys or posts; agents should confirm firstaccounts_listFreeList the imported accounts: bank, currencies, transaction count, first and last date, and the closing balance when the file carried one. Start here for the account names transactions_list and statement_export take.
bank_delete_uploadwrite actionFreeDelete one statement file stored for your token. The transactions already imported from it are kept; transactions_list and the summary still see them.
bank_filesFreeList the statement files stored for your token, with their sizes.
bank_uploadwrite actionFreeSend a bank export to this hosted endpoint. There is no filesystem here, so instead of a path you upload the file once with bank_upload and then pass its name as `path` to statement_import. Give exactly one of content (the export as text, header row included - this is the normal case for a CSV), content_base64 (the file's bytes, which keeps a UTF-16 export from Excel readable) or url. url: fetch a public file instead of pasting base64 (recommended above about 10 KB): the url is fetched here with a 10 second timeout, at most 3 redirects, public http(s) hosts only, and a 1 MB cap; the fetched file has to be delimited text, so a PDF statement is refused rather than stored. Uploads are kept for your token between calls; bank_files lists them and bank_delete_upload removes one. The request body cap is 256 KB, so a large export pasted as text has to be split by month.
category_rulesFreeRead the category rules, or pass rules to REPLACE the whole list. A plain match is a substring; a regex compiles only if it cannot backtrack exponentially. An empty match is refused. Free: 5 rules.
license_activateFreeTurn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.
license_statusFreeReport this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.
reconcile_expensesFreeMatch bank debits against mcp-expense-tracker entries: same currency and amount, date within a few days. Reports matches, unmatched bank lines, expenses never hitting the bank. Read-only. Free: 31 days; Pro: any range.
recurring_detectFreeFind charges that come back: debits grouped by counterparty and currency with a steady amount and interval, with cadence, typical amount, next due date and annual cost. Free: 3 months, 5 charges.
statement_exportFreeExport the BANK transactions of a date range (a month, a quarter, a year) as .csv or .json and return a download link valid for one hour. This is the tool for "export September" once a statement has been imported. Nothing partial is ever written.
statement_importFreeCall this tool to read a bank CSV into the local ledger. Columns detected from headers (date, description, amount, currency, balance); amounts use the file's locale; stored lines skipped. Returns detected/stored/skipped.
statement_summaryFreeWhat was spent/received in a date range per the BANK ACCOUNT, grouped by category, month, account or counterparty. For "what did I spend in August" once imported. Totals are per currency, never summed or converted.
transaction_categorizeFreeSet or clear the category on transactions by id, for a one-off no rule is worth writing for. Every id is checked first, so one unknown id refuses the whole call. category_rules matches by text instead.
transactions_listFreeList stored transactions in a date range, optionally for one account or category, or only the ones no rule has categorised yet. Totals are reported per currency and never added across currencies.
transactions_searchFreeFind transactions whose description, counterparty, category or account contains the query. Case-insensitive substring search, never a regex, so a query with brackets in it cannot hang the server.
Public scan report
scanner v0.1.2 · 2026-09-17 · same rubric, same numbers if you re-run it
- –Code scanpackage could not be scannedn/a
- Live reliabilityremote reachable in 474ms20/20
- Tool poisoning15 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancerepository not readable: github 4013/15
- Maintainer identityno repository or website to verify2/10
Install directly
claude mcp add --transport http bank-statement-csv-categorize-reconcile-ledger https://mcp.zovo.one/mcp/bank-statement