Skip to content
MCP server

Chargescout

Find subscriptions, price rises and double charges in a bank statement CSV, locally

Runs locally
Install
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 chargescout

Add to claude_desktop_config.json

{
  "mcpServers": {
    "chargescout": {
      "command": "npx",
      "args": [
        "-y",
        "chargescout"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chargescout": {
      "command": "npx",
      "args": [
        "-y",
        "chargescout"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers