# Chargescout

> Chargescout is an open-source MCP server for finance and payments. Find subscriptions, price rises and double charges in a bank statement CSV, locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/gillmacedo/chargescout
- **MCP Registry name:** io.github.GillMacedo/chargescout
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add chargescout -- npx -y chargescout
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "chargescout": {
      "command": "npx",
      "args": [
        "-y",
        "chargescout"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "chargescout": {
      "command": "npx",
      "args": [
        "-y",
        "chargescout"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "chargescout": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "chargescout"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "chargescout": {
      "command": "npx",
      "args": [
        "-y",
        "chargescout"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "chargescout": {
      "command": "npx",
      "args": [
        "-y",
        "chargescout"
      ]
    }
  }
}
```

## Tools

- `subscriptions_find`: Returns recurring charges, yearly cost and alerts.
- `subscriptions_inspect_csv`: Shows detected columns and row counts without row contents.

## 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.

## Alternatives

- [Handsome Local](https://ai-powered.com/mcp/handsome-local): Handsome Local is a paid MCP server for finance and payments.
- [CSV Repair](https://ai-powered.com/mcp/csv-repair): CSV Repair is a freemium MCP server for files and documents.
- [Chartsy](https://ai-powered.com/mcp/chartsy): Chartsy is an MCP server for analytics and data.
- [RevClamp MCP Server](https://ai-powered.com/mcp/revclamp-mcp-server): RevClamp MCP Server is a freemium MCP server for finance and payments.
- [Budget it](https://ai-powered.com/mcp/budget-it): Budget it is an open-source MCP server for finance and payments.
- [Bills AI](https://ai-powered.com/mcp/bills-ai): Bills AI is a freemium MCP server for finance and payments.
- [Aurio Bank Statement](https://ai-powered.com/mcp/aurio-bank-statement): Aurio Bank Statement is a freemium MCP server for finance and payments.
- [DocFig](https://ai-powered.com/mcp/docfig): DocFig is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/chargescout
