Skip to content
MCP server

Billparse

Turn invoice PDFs, scans and photos into spreadsheets, JSON and arithmetic checks

Runs locally
Install
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally
Version
0.1.0
Listing updated
4 days ago

Similar MCP servers

About Billparse

Billparse is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MIT licence; hosted parsing service pricing not published

Billparse 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 Feeds.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers