Billparse
Turn invoice PDFs, scans and photos into spreadsheets, JSON and arithmetic checks
- 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/billparseAdd to claude_desktop_config.json
{
"mcpServers": {
"billparse": {
"command": "npx",
"args": [
"-y",
"@reneturcios/billparse"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"billparse": {
"command": "npx",
"args": [
"-y",
"@reneturcios/billparse"
]
}
}
}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.
