# Bank Statement Parser

> Bank Statement Parser is a freemium MCP server for finance and payments. Converts PDF bank statements into QBO, Xero, Excel, CSV or JSON for bookkeepers. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** API, CLI, Web
- **Website:** https://bankstatementparser.net
- **Repository:** https://github.com/yavuzceliker/bankstatementparser-mcp
- **MCP Registry name:** io.github.yavuzceliker/bankstatementparser-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-18

## About

The README says the server wraps the Bank Statement Parser API so MCP clients such as Claude Desktop, Cursor or Windsurf can send a local PDF and receive balance-checked transaction data back. Scanned and password-protected statements are handled through the same tool, and the parser flags rows whose running balance does not reconcile.

A single parse_bank_statement tool accepts a file path, an optional password and an output format covering JSON, CSV, Xero CSV, QBO, OFX, IIF and Tally XML. Zero-retention processing is on by default, keeping files in memory. Scanned or unfamiliar layouts can return a queue id, which is then polled with a separate status tool.

The package suits people who already work with an AI assistant and need statements turned into accounting imports, as well as accounting practices and developers building bookkeeping pipelines. Use of the service requires an API key, and the free allowance is 15 pages.

## Features

- **Multiple accounting export formats:** Output can be JSON, CSV, Xero CSV, QBO, OFX, IIF or Tally XML.
- **Running-balance verification:** Each parsed row is checked against the running balance and reported in a confidence block.
- **Scanned and encrypted PDF support:** OCR handles scanned statements and an optional password unlocks protected files.
- **Zero-retention mode:** Files are processed in memory by default when zero_retention is enabled.
- **Async queue polling:** Scanned or unseen layouts return a queue id that a status tool can poll.

## Good for

- Converting a client's bank PDFs into QBO or Xero files for import
- Extracting transactions from scanned statements inside an AI assistant workflow
- Building a batch pipeline that turns statements into JSON for reconciliation
- Checking statement rows against running balances before bookkeeping

## Install

### Claude Code (Terminal)

```sh
claude mcp add bankstatementparser-mcp --env BANK_STATEMENT_PARSER_API_KEY='<BANK_STATEMENT_PARSER_API_KEY>' -- npx -y bankstatementparser-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bankstatementparser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bankstatementparser-mcp"
      ],
      "env": {
        "BANK_STATEMENT_PARSER_API_KEY": "<BANK_STATEMENT_PARSER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bankstatementparser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bankstatementparser-mcp"
      ],
      "env": {
        "BANK_STATEMENT_PARSER_API_KEY": "<BANK_STATEMENT_PARSER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "bankstatementparser-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bankstatementparser-mcp"
      ],
      "env": {
        "BANK_STATEMENT_PARSER_API_KEY": "<BANK_STATEMENT_PARSER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bankstatementparser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bankstatementparser-mcp"
      ],
      "env": {
        "BANK_STATEMENT_PARSER_API_KEY": "<BANK_STATEMENT_PARSER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bankstatementparser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bankstatementparser-mcp"
      ],
      "env": {
        "BANK_STATEMENT_PARSER_API_KEY": "<BANK_STATEMENT_PARSER_API_KEY>"
      }
    }
  }
}
```

## Tools

- `parse_bank_statement`: Parses a local bank statement PDF into the chosen output format with a verification confidence block.
- `check_extraction_status`: Polls an async queue_id for scanned or unseen bank layouts.

## FAQ

### How do I install the MCP server?

The README gives a config block that runs the npm package bankstatementparser-mcp through npx, with BANK_STATEMENT_PARSER_API_KEY set in the environment.

### Is there a free option?

The website lists a free plan with 15 lifetime pages and no credit card required.

### Are uploaded files kept?

The website says standard queue files auto-delete within 14 days, and Zero Retention mode processes files strictly in memory.

### Which tools does the server expose?

The README lists parse_bank_statement and check_extraction_status.

### Is Bank Statement Parser free?

Bank Statement Parser has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

### How do I add Bank Statement Parser to Claude Code?

Run this command in your terminal: claude mcp add bankstatementparser-mcp --env BANK_STATEMENT_PARSER_API_KEY='<BANK_STATEMENT_PARSER_API_KEY>' -- npx -y bankstatementparser-mcp

### What are the best alternatives to Bank Statement Parser?

The closest alternatives to Bank Statement Parser are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/bank-statement-parser
