# Billparse

> Billparse is an open-source MCP server for finance and payments. Turn invoice PDFs, scans and photos into spreadsheets, JSON and arithmetic checks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/cloudcorprecords/billparse
- **MCP Registry name:** io.github.CloudCorpRecords/billparse
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-15

## About

Invoices arrive in awkward formats, and this bridge hands them to the hosted InvoiceParserPro service. It accepts a document three ways: an https `file_url`, base64 bytes with an optional file name, or a client-attached file object. Parsing happens upstream; the package only answers tools/list and forwards calls unchanged.

invoice_to_excel returns header fields, line items and download links to an Excel file and a CSV, which the README says stay valid for 60 minutes without signing in, plus a job_id. check_invoice tests the arithmetic: quantity times unit price per line, lines against the subtotal, tax against its printed rate, and subtotal plus tax against the total, quoting the invoice's own numbers. extract_invoice_data returns JSON with vendor, customer, number, dates, PO number, currency, totals, tax lines, line items and a confidence figure overall and per field. get_result re-fetches outputs by job_id so you do not submit the same document twice.

Install with npx or Docker. An optional INVOICEPARSERPRO_API_KEY is sent as a Bearer header. MIT licensed.

## Features

- **Excel and CSV output:** invoice_to_excel returns header fields, line items and download links.
- **Arithmetic check:** check_invoice verifies line totals, subtotal, tax rate and total.
- **Structured extraction:** extract_invoice_data returns JSON with per-field confidence.
- **Result retrieval:** get_result reuses a job_id instead of resubmitting.
- **Three input forms:** Link, base64 bytes or an attached file.
- **CLI and Docker:** One binary serves command line and MCP.

## Good for

- Move invoice line items into a spreadsheet
- Catch invoices whose totals do not add up
- Feed vendor and tax data into accounting software
- Re-download outputs for an invoice already processed

## Install

### Claude Code (Terminal)

```sh
claude mcp add billparse -- npx -y @reneturcios/billparse
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "billparse": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/billparse"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "billparse": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/billparse"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "billparse": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/billparse"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "billparse": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/billparse"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "billparse": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/billparse"
      ]
    }
  }
}
```

## Tools

- `invoice_to_excel`: Reads an invoice and returns fields, line items and Excel and CSV download links
- `check_invoice`: Tests whether an invoice's arithmetic adds up
- `extract_invoice_data`: Extracts an invoice into structured JSON with confidence figures
- `get_result`: Retrieves outputs for an earlier job_id

## FAQ

### Is parsing done locally?

No. Calls are forwarded to the hosted InvoiceParserPro service.

### How long do download links last?

60 minutes, per the captured tool description.

### What input formats can I send?

A file URL, base64 content or an attached file.

### Does it check the maths?

Yes, check_invoice tests line, subtotal, tax and total arithmetic.

### Is Billparse free?

Yes. Billparse is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add billparse -- npx -y @reneturcios/billparse

### What are the best alternatives to Billparse?

The closest alternatives to Billparse are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, SSRS2 and Crypto Fng.

## Where this comes from

- Description: written from the project's README.
- 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.
- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Csv](https://ai-powered.com/mcp/csv): Csv is a freemium MCP server for files and documents.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.

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