Parserbee Mcp

io.github.ParserBeePublished by GitHub account ParserBeev0.1.1Updated Oct 24, 2026

Extract structured data from invoices, receipts and other documents with ParserBee.

VerifiedSTDIODesktop onlyFiles & StorageData & Analytics

Overview

AI-generated overview

ParserBee MCP lets an assistant extract structured data from invoices, receipts and other documents using your ParserBee Parser Templates.

What you can do
  • Extract structured fields from a local file or public link using a Parser Template, one page credit per page
  • List your Parser Templates and read a single template with all of its fields
  • Check page credit balance, plan and subscription status
  • Review the last 10 extraction requests and fetch one request with its extracted data
When to use it
Useful when you want an assistant to pull structured fields out of invoices, receipts, purchase orders or bank statements, or to batch-read a folder of receipts into a table, without leaving the chat.
Requirements
Runs locally over stdio via npx, so Node.js 18 or later is needed. A ParserBee account with at least one Parser Template, and an API key supplied in the PARSERBEE_API_KEY environment variable. Network access to the ParserBee service; an optional PARSERBEE_BASE_URL overrides the default endpoint.
Before you install
The API key in PARSERBEE_API_KEY is a secret and should be kept out of shared config files. Extraction consumes paid page credits (one per page) and fails when the balance runs out. Documents, including local files, are uploaded to ParserBee's service for processing, so avoid sending sensitive material you would not share with that third party.

Installation

In SourceWeft

  1. Open Parserbee Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ParserBee MCP server

[parserbee-mcp MCP server – quality and maintenance score on Glama]

A Model Context Protocol server for ParserBee. It lets an AI assistant extract structured data from invoices, receipts, purchase orders, bank statements and other documents, using your Parser Templates.

Ask your assistant things like:

  • "Extract the invoice in ~/Downloads/inv-2041.pdf with my Invoice template."
  • "Read every receipt in this folder and give me a table of merchant, date and total."
  • "How many ParserBee page credits do I have left?"

Tools

ToolWhat it does
extract_documentExtract data from a local file (file_path) or a public link (file_url) with a Parser Template. 1 page credit per page.
list_templatesList the Parser Templates in your account, with their fields
get_templateOne Parser Template with all of its fields
get_creditsPage credit balance, plan and subscription status
list_recent_extractionsThe last 10 extraction requests
get_extractionOne extraction request, with its extracted data

Before you start

  1. Create a free account at app.parserbee.com. New accounts get 25 free pages, no credit card.
  2. Create a Parser Template: upload one sample document and the AI builds the fields for you, or pick a ready-made one from the template library.
  3. Copy your API key from Settings in the dashboard. It starts with pk_.

You need Node.js 18 or later.

Set up

Claude Desktop

Open Settings > Developer > Edit Config and add:

json
{  "mcpServers": {    "parserbee": {      "command": "npx",      "args": ["-y", "parserbee-mcp"],      "env": { "PARSERBEE_API_KEY": "pk_your_api_key" }    }  }}

Restart Claude Desktop.

Claude Code

bash
claude mcp add parserbee --scope user -e PARSERBEE_API_KEY=pk_your_api_key -- npx -y parserbee-mcp

--scope user makes ParserBee available in every folder. Without it, Claude Code adds the server only to the folder you run the command in. Start a new Claude Code session afterwards, then check it with claude mcp list.

Cursor

Add the same mcpServers block to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).

VS Code

Add to .vscode/mcp.json:

json
{  "servers": {    "parserbee": {      "command": "npx",      "args": ["-y", "parserbee-mcp"],      "env": { "PARSERBEE_API_KEY": "pk_your_api_key" }    }  }}

From a local copy

bash
git clone https://github.com/ParserBee/parserbee-mcp.gitcd parserbee-mcpnpm installPARSERBEE_API_KEY=pk_your_api_key node dist/index.js

Point your client at node /path/to/parserbee-mcp/dist/index.js.

Settings

Environment variableRequiredUse
PARSERBEE_API_KEYYesYour API key from Settings
PARSERBEE_BASE_URLNoDefaults to https://app.parserbee.com

What comes back

extract_document returns the API response. The extracted fields are in data, shaped like your Parser Template:

json
{  "success": true,  "request_id": "req_abc123",  "data": {    "invoice_number": "INV-2026-001",    "vendor_name": "Acme Corp",    "total_amount": 1500  },  "credits_remaining": 449,  "usage": { "pages_processed": 1, "credits_charged": 1 }}

Files can be PDF, PNG, JPG, WebP or HEIC, up to 50 MB. Scans and phone photos work. API errors (an invalid key, no page credits left, an unknown template) come back as tool errors with the ParserBee error code, so the assistant can tell you what to fix.

Try it

The sample-invoices repository has 18 free test invoices with the correct value of every field, so you can check the results.

Related

Development

bash
npm installnpm testnpm run build

License

MIT

Source: README.md at commit 8162c31

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestOct 14, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts