# BankConv

> BankConv is a freemium MCP server for files and documents. Convert PDF bank statements into transactions, CSV, OFX, QFX, QBO or Xero CSV. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Website:** https://bankconv.com/integrations/mcp
- **Repository:** https://github.com/wassim/bankconv-mcp
- **MCP Registry name:** io.github.wassim/bankconv-mcp
- **Categories:** files and documents, finance and payments
- **Listing updated:** 2026-11-14

## About

BankConv MCP lets an assistant turn a PDF statement on your computer into data you can use. It uploads the PDF to BankConv, waits for the conversion, and then either returns every transaction as JSON or saves a file next to the PDF. Amounts are signed, with money in positive and money out negative, dates are full ISO dates even when the statement shows only day and month, and opening balance and total lines are left out.

Format choice follows the accounting package: OFX for Xero, MYOB, Sage and QuickBooks Online, QFX for Quicken, QBO for QuickBooks Desktop and a Xero CSV with Xero's own columns. Password-protected, scanned and multi-page statements are supported.

It needs a BankConv API key, and conversions use pages from your plan. The README says uploaded PDFs and converted files are deleted after 24 hours by default, and the server only reads files you name. It requires Node.js 20 or later and the source is MIT licensed.

## Features

- **Transaction extraction:** Returns a summary plus every row as JSON with signed amounts and ISO dates.
- **Accounting file export:** Saves CSV, OFX, QFX, QBO or Xero CSV beside the PDF.
- **Scanned and protected PDFs:** Handles password-protected, scanned and multi-page statements.
- **Conversion history:** Lists earlier conversions and re-downloads them in another format.
- **Page balance check:** Shows how many pages remain in the billing period.

## Good for

- Total a month's spending by category from a statement PDF
- Prepare a year of statements as OFX for Xero
- Create a QBO file for QuickBooks Desktop
- Find the largest expenses in a statement

## Install

### Claude Code (Terminal)

```sh
claude mcp add bankconv-mcp --env BANKCONV_API_KEY='<BANKCONV_API_KEY>' -- npx -y bankconv-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `convert_statement`: Converts a PDF on your computer and returns transactions or saves an export file.
- `get_transactions`: Gets the transactions of an earlier conversion.
- `download_statement`: Saves an earlier conversion as CSV, OFX, QFX, QBO or Xero CSV.
- `list_conversions`: Lists recent conversions with their status.
- `get_credits`: Shows how many pages are left this period.

## FAQ

### What do I need to run it?

A BankConv API key and Node.js 20 or later.

### What does it cost?

The first statement has a free tier; then $2.99 for up to 10 pages pay-per-document, or plans from $19 per month billed yearly.

### Where does my PDF go?

It is uploaded to BankConv over HTTPS and deleted automatically after 24 hours by default.

### Which formats are supported?

CSV, OFX, QFX, QBO and Xero CSV.

### Is BankConv free?

BankConv has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

### How do I add BankConv to Claude Code?

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

### What are the best alternatives to BankConv?

The closest alternatives to BankConv are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, ASTra and Quantivex Research.

## 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.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [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.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.

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