Chargescout
Find subscriptions, price rises and double charges in a bank statement CSV, locally
- Pricing
- Open source
- Platforms
- CLI
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
- 4 days ago
Similar MCP servers
About Chargescout
Chargescout is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Chargescout works from a CSV export instead of a bank login. It looks for charges from one merchant that repeat weekly, monthly, quarterly or yearly, then reports each one's cost per year, the date of the last charge and whether it seems to have stopped. It also flags price increases and possible double charges, and notes when an amount varies enough that it may be a usage-based bill.
The rules are explicit. Four or more steady charges count as recurring. Three charges, two a year apart, or a bill whose amount changes most cycles are marked likely. A charge that is overdue by the end of the statement is shown as may have stopped and left out of the total. Amounts must stay within 25% so everyday shopping is not reported.
It is a single Go binary with no account, API key or network access. Through MCP, merchant names and amounts reach whichever model you use; the command line keeps everything local. Limits include CSV only, merchant names that may split one company in two, no currency conversion, and testing so far on made-up data. It is MIT licensed.
Install
Run in a terminal
claude mcp add chargescout -- npx -y chargescoutAdd to claude_desktop_config.json
{
"mcpServers": {
"chargescout": {
"command": "npx",
"args": [
"-y",
"chargescout"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"chargescout": {
"command": "npx",
"args": [
"-y",
"chargescout"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"chargescout": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"chargescout"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"chargescout": {
"command": "npx",
"args": [
"-y",
"chargescout"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"chargescout": {
"command": "npx",
"args": [
"-y",
"chargescout"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- subscriptions_find
- Returns recurring charges, yearly cost and alerts.
- subscriptions_inspect_csv
- Shows detected columns and row counts without row contents.
What it does
- Recurring charge detection
- Finds weekly, monthly, quarterly and yearly repeats by merchant.
- Price-rise alerts
- Flags when a subscription's price went up and by how much.
- Double-charge flags
- Marks possible duplicate charges.
- Yearly cost estimate
- Totals the annual cost of active recurring charges.
- Column detection
- Recognises common column names, or you can name your own.
- Local only
- No bank login, account, API key or network code.
Good for
- List every subscription a freelancer pays for
- Find a forgotten annual renewal
- Spot which services raised prices
- Check for double billing
- Decide what a small business could cancel
Pricing
Open source
MIT licensed; no account or API key
Chargescout FAQ
Do I have to connect my bank?
No. It reads only the CSV file you give it.
Can it cancel subscriptions?
No. It shows what is there and you cancel with each provider.
Does my data leave my machine?
The CLI is local. Through MCP, merchant names and amounts go to the AI model you use.
What are the limits?
CSV only, no currency conversion, merchant names can split, and an annual cost is an estimate.
Is Chargescout free?
Yes. Chargescout is open source, so you can use and self-host it for free.
How do I add Chargescout to Claude Code?
Run this command in your terminal: claude mcp add chargescout -- npx -y chargescout
What are the best alternatives to Chargescout?
The closest alternatives to Chargescout are Handsome Local, CSV Repair, Chartsy, RevClamp MCP Server and Budget it.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
