Use InvoiceParser Pro in Claude, ChatGPT and Cursor
Ask your assistant to turn an invoice into a spreadsheet, check whether its math adds up, or pull out every field and line item. InvoiceParser Pro reads the document the same way it does on the website, and the answer comes back in the chat.
https://api.invoiceparserpro.com/mcpFour tools, one invoice at a time
invoice_to_excelReads the invoice and returns the header fields, every line item, and download links to an Excel (.xlsx) and a CSV file.
check_invoiceChecks each line (quantity times unit price), the lines against the subtotal, the tax against its printed rate, and the total. Returns a one-line verdict and every problem it found, with the invoice’s own numbers.
extract_invoice_dataReturns the whole read as JSON: vendor and customer, numbers and dates, PO number, currency, totals, tax lines, every line item, and confidence for the document and for each field.
get_resultA document that is still being read when a call returns comes back with a job_id; get_result fetches it a little later.
Connect your assistant
Each tool takes one file: an https link the server can download (file_url), the file's bytes in base64 (file_base64), or, in ChatGPT, the attached file. PDFs and photos up to 10 MB.
Claude (claude.ai and the Claude desktop app)
- Open Settings, then Connectors, and choose Add custom connector.
- Name it InvoiceParser Pro and paste https://api.invoiceparserpro.com/mcp as the URL. Leave authentication empty.
- In a chat, turn the connector on from the tools menu and ask, for example: “Turn this invoice into a spreadsheet: <link>”.
Files: Give Claude an https link to the file (a public or shared link from your file storage). Claude may not be able to pass a file attached to the chat on to a connector; a link always works.
Key: A custom connector here cannot send an API key header (it signs in with OAuth, which this server does not offer yet), so Claude uses the free trial lane.
Claude Code
- Add the server from your terminal, with or without a key:
claude mcp add --transport http invoiceparser-pro https://api.invoiceparserpro.com/mcp
# with a key (documents go into your workspace):
claude mcp add --transport http invoiceparser-pro https://api.invoiceparserpro.com/mcp \
--header "Authorization: Bearer ipp_mcp_..."Files: Claude Code can read a file on your computer and send it as base64 (file_base64), or pass an https link (file_url).
Key: Yes: the --header line above.
ChatGPT
- Open Settings, then Apps & Connectors, then Advanced settings, and turn on Developer mode (a paid ChatGPT plan is needed for custom connectors).
- Create a connector with https://api.invoiceparserpro.com/mcp as its URL and no authentication.
- In a chat, add the connector from the + menu, attach the invoice, and ask for the spreadsheet or the math check.
Files: Attach the file in the chat: the tools declare a file input (the Apps SDK’s file parameters), so ChatGPT can hand the tool a temporary download link. An https link to the file works too.
Key: The free trial lane.
Cursor
- Add the server to .cursor/mcp.json (or your global MCP settings):
{
"mcpServers": {
"invoiceparser-pro": {
"url": "https://api.invoiceparserpro.com/mcp",
"headers": { "Authorization": "Bearer ipp_mcp_..." }
}
}
}Files: The agent can read a file in your project and send it as base64, or pass an https link.
Key: Yes: the headers line (leave it out for the free trial lane).
VS Code and other MCP clients
- Add a remote (HTTP) MCP server with the URL https://api.invoiceparserpro.com/mcp. The transport is Streamable HTTP.
{
"servers": {
"invoiceparser-pro": {
"type": "http",
"url": "https://api.invoiceparserpro.com/mcp",
"headers": { "Authorization": "Bearer ipp_mcp_..." }
}
}
}Files: file_url (an https link) or file_base64 (the file’s bytes).
Key: Any client that can send an HTTP header can use a key.
A free trial
- Up to 10 documents a day per network address, inside a shared monthly budget. Hosted assistants (Claude.ai, ChatGPT) share their addresses among all their users, so the allowance may already be used up there; the answer says when it is back.
- The file and its results are deleted 7 days after upload.
- Every answer ends with a link that saves the results to a free account (25 invoices a month, no card).
- Spreadsheet links work for 60 minutes, without signing in.
Your workspace, your plan
- Every paid plan (Starter, Team and Scale) can create an AI assistant key on the API Access page.
- Documents go into your workspace’s review queue and count against your plan’s monthly invoices. Prices do not change.
- Send it as Authorization: Bearer ipp_mcp_… from any client that can set a header.
- An assistant key works only with assistants. The REST API stays on Scale, and a Scale key works in both.
Where your invoice goes
InvoiceParser Pro reads the document exactly as it does on the website, with the same providers. Without a key, the file and its results are deleted 7 days after upload unless you save them to an account; with a key, the document lives in your workspace like any upload. The free trial counts a connection's documents under a keyed hash of its IP address, not the address itself. See the privacy policy and security.
Your AI assistant's company sees what you give the assistant (the file or the link) and what the tools send back (fields, line items, the math check, the download links), under its own terms.
Links: the server downloads public https links only. Private, internal and plain-http addresses are refused, including through redirects.
Questions about the MCP server
Rather use the website?
The free tool turns an invoice into Excel in the browser, with the math checked. The REST API is documented for developers.