Parzo Invoice Extraction

by ira-francesco

295 downloads
Not rated
GitHub

About

Extract structured data from any invoice PDF. Returns clean JSON with vendor, buyer, line items, financials and confidence score.

Details

Author
ira-francesco
Downloads
295
Categories
Finance

- Extracts structured data (vendor, buyer, line items, financials) from invoice PDFs.
- Provides two tools: extract_invoice and get_job.
- Polls for results automatically and returns full JSON with validation flags.
- Works with any MCP-compatible AI client (Claude, Cursor, etc.).
- Open source and published on npm as parzo-mcp.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Parzo Invoice Extraction
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the server globally via npm (npm install -g parzo-mcp), then configure it in your MCP client (Claude Code or Cursor) by adding a parzo entry with the command parzo-mcp and your Parzo API key in the env block. Once connected, you can use natural language prompts such as "Extract the invoice data from /path/to/invoice.pdf" to invoke the tools.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "parzo invoice extraction": {
            "parzo": {
                "command": "npx",
                "args": [
                    "parzo-mcp"
                ],
                "env": {
                    "PARZO_API_KEY": "inv_your_key_here"
                }
            }
        }
    }
}

McpServers

{
    "parzo": {
        "command": "npx",
        "args": [
            "parzo-mcp"
        ],
        "env": {
            "PARZO_API_KEY": "inv_your_key_here"
        }
    }
}

---
MCP Server
Use Parzo directly inside Claude, Cursor, and any MCP-compatible AI client.
---

Parzo ships a native MCP (Model Context Protocol) server. Once installed, your AI agent can extract invoice data without writing a single line of integration code — just point it at a PDF and ask.

Installation



Install the MCP server globally via npm:

``bash
npm install -g parzo-mcp
`

Configuration



Claude Code



Add Parzo to your Claude Code MCP config file:

<CodeGroup>

`json macOS / Linux (~/.claude/claude_desktop_config.json)
{
"mcpServers": {
"parzo": {
"command": "parzo-mcp",
"env": {
"PARZO_API_KEY": "inv_your_key_here"
}
}
}
}
`

`json Windows (%APPDATA%\Claude\claude_desktop_config.json)
{
"mcpServers": {
"parzo": {
"command": "parzo-mcp",
"env": {
"PARZO_API_KEY": "inv_your_key_here"
}
}
}
}
`

</CodeGroup>

Replace
inv_your_key_here with your Parzo API key. Get one free →

Cursor



Add the following to your Cursor MCP settings:

`json
{
"mcpServers": {
"parzo": {
"command": "parzo-mcp",
"env": {
"PARZO_API_KEY": "inv_your_key_here"
}
}
}
}
`

Available tools



extract_invoice



Extracts structured data from an invoice PDF file.

| Parameter | Type | Description |
|-----------|------|-------------|
|
file_path | string | Absolute path to the PDF file on your local machine |
|
api_key | string | Your Parzo API key (optional if set via env) |

Example prompt:

`
Extract the invoice data from /Users/me/invoices/acme-april.pdf
`

The agent will call
extract_invoice, poll for the result, and return the full JSON — vendor, buyer, line items, financials, and validation flags.

get_job



Retrieves the status and result of an existing extraction job.

| Parameter | Type | Description |
|-----------|------|-------------|
|
job_id | string | The job ID returned by a previous extraction |
|
api_key | string | Your Parzo API key (optional if set via env) |

Example prompt:

`
Get the result of job 3419ae1e-93c3-48a1-95ac-833c390f9916
`

Example workflow



Once Parzo is connected, you can use natural language to process invoices:

`
I have 3 invoices in ~/Downloads/invoices/.
Extract the data from each one and give me a summary
of the total amount due and due dates.
`

The agent will automatically call
extract_invoice for each file and synthesize the results.

Verify the connection



After adding the config, restart your client and run:

`
List the available Parzo tools
`

You should see
extract_invoice and get_job listed.

Troubleshooting



"Missing X-API-Key header" — Make sure your API key is set correctly in the
env block of your config file.

"File not found" — Use the absolute path to the PDF. On Windows with WSL, use
/mnt/c/Users/... format.

Server not showing up — Restart your MCP client after editing the config file.

---

<Note>
The MCP server is open source and published on npm as
parzo-mcp`.
Found a bug? Open an issue on GitHub.
</Note>

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.