Parzo Invoice Extraction
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:
npm install -g parzo-mcp
Configuration
Claude Code
Add Parzo to your Claude Code MCP config file:
{
"mcpServers": {
"parzo": {
"command": "parzo-mcp",
"env": {
"PARZO_API_KEY": "inv_your_key_here"
}
}
}
}
{
"mcpServers": {
"parzo": {
"command": "parzo-mcp",
"env": {
"PARZO_API_KEY": "inv_your_key_here"
}
}
}
}
Replace inv_your_key_here with your Parzo API key. Get one free →
Cursor
Add the following to your Cursor MCP settings:
{
"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.
Server Config
{
"mcpServers": {
"parzo": {
"command": "npx",
"args": [
"parzo-mcp"
],
"env": {
"PARZO_API_KEY": "inv_your_key_here"
}
}
}
}