Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@chargescout find all my recurring subscriptions in statement.csv"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
See every subscription you're paying for, what it costs per year, which prices went up, and where you were charged twice, without linking your bank account or uploading anything. For small businesses, freelancers and anyone auditing their spending.
Subscription trackers usually want your bank login and charge a monthly fee. chargescout reads a CSV export from your bank or card instead, and finds the charges that repeat weekly, monthly, quarterly or yearly. It's an MCP server and a single Go binary, with no account, no API key and no network access.
"What subscriptions am I paying for?"
"How much do my recurring charges cost per year?"
"Which subscription prices went up?"
"Was I charged twice for anything?"
"What should my business cancel to save money?"
Related MCP server: finpilot
As a Claude Code plugin, which adds the MCP server and a skill that tells Claude when to use it. You need Node, which runs the server through npx:
claude plugin marketplace add GillMacedo/chargescout
claude plugin install chargescout@chargescout-marketplaceFor other MCP clients:
{
"mcpServers": {
"chargescout": {
"command": "npx",
"args": ["-y", "chargescout", "serve"]
}
}
}Or build the binary with Go 1.27 or newer:
go install github.com/GillMacedo/chargescout@latestWithout installing anything, run npx chargescout find statement.csv. This example uses the made-up statement in examples/:
$ go run . find examples/statement.csv
SAMPLE POWER CO 83.30 monthly 999.60/year last 2026-09-12 active (likely)
! amount varies, so this may be a usage-based bill
MOCK ACCOUNTING SOFTWARE 60.00 quarterly 240.00/year last 2026-08-25 active (likely)
SAMPLE STREAM 18.99 monthly 227.88/year last 2026-09-03 active
! price went up from 15.99 to 18.99 on 2026-06-03
PLACEHOLDER DOMAINS ANNUAL 120.00 yearly 120.00/year last 2026-09-14 active (likely)
EXAMPLE CLOUD STORAGE 9.99 monthly 119.88/year last 2026-09-07 active
! possible double charge of 9.99 on 2026-06-08
FICTIONAL GYM MEMBERSHIP 45.00 monthly 540.00/year last 2026-05-21 may have stopped
SKIPPED row 59: no valid date or amount
6 recurring charges, 5 active, costing 1707.36 a yearAdd --positive-out if your file shows charges as positive numbers, as many card statements do, and --json for machine-readable output. A longer statement gives better results, and a year of history is ideal.
Finding | Rule |
Recurring | 4 or more charges from one merchant at a steady interval and price |
Likely | 3 charges, 2 charges a year apart, or a steady bill whose amount changes most cycles |
May have stopped | The next charge is overdue by the end of the statement. It's left out of the total |
Most intervals must fit the cycle, and amounts must stay within 25%, so everyday shopping isn't reported. Two plans from one company stay separate.
Tool | What it does |
| Returns recurring charges, yearly cost and alerts, with a limit for long results |
| Shows detected columns and row counts, without row contents |
Both are read-only. subscriptions_find returns merchant names and amounts to the MCP client, so they reach whichever AI model you use. The CLI keeps everything on your machine.
How do I find forgotten subscriptions? Export your bank or card transactions as CSV and run npx chargescout find statement.csv.
Do I have to connect my bank account? No. It only reads the file you give it, and it has no network code.
Can it cancel subscriptions? No. It shows you what's there, and you cancel with each provider.
Does it work with my bank? It reads CSV exports and recognizes common column names in several languages, and you can name others with --columns date=When,amount=Sum,description=What. It hasn't been tested on each bank's real exports yet.
This helps you review spending and isn't financial advice. Check results against your statement.
It reads CSV only, so PDF statements need converting first.
Merchant names come from bank descriptions, so one company can appear under two names, and those won't be connected.
It can miss charges with irregular timing, and can report steady non-subscription spending, such as rent or a regular purchase.
Yearly cost is the last amount times the cycles per year, so it's an estimate.
It assumes two decimal places, and doesn't convert currencies.
So far it has been tested on made-up data, not real exports. If yours fails, please open an issue with the column headers, not your data.
Contributions are welcome, from people and from people working with AI agents. See CONTRIBUTING.md. Good first issues:
Add column names from more banks and languages
Add more card-processor prefixes to merchant name cleanup
Connect the same merchant under different names
Add --out to write results to a CSV
Add a plugin icon
This project was largely generated with Claude Code and reviewed by its maintainer.
I'm Giulliano Macedo, and I build developer tools at GoTech Solutions. Follow along or get in touch:
GitHub: GillMacedo
LinkedIn: giulliano
X: @giumacedo
If chargescout found a charge you forgot about, a star helps others find it.
MIT licensed.
Built by Giulliano Macedo, GoTech Solutions · LinkedIn · X
This server cannot be deployed
Finds recurring charges in bank statements and flags what to cancel.
Turn bank statement PDFs, CSVs, XLSX and OFX into categorised transactions plus a summary.
Ask Claude about your income and spending, and import bank statements. No bank login.
Track expenses from your AI chat: log, categorize, monthly CSV reports. All data is local.
