ParserBee/parserbee-mcp

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
| Tool | What it does |
| extractdocument | Extract data from a local file (filepath) or a public link (fileurl) with a Parser Template. 1 page credit per page. |
| listtemplates | List the Parser Templates in your account, with their fields |
| gettemplate | One Parser Template with all of its fields |
| getcredits | Page credit balance, plan and subscription status |
| listrecentextractions | The last 10 extraction requests |
| getextraction | One 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": { "PARSERBEEAPIKEY": "pkyourapikey" }
Restart Claude Desktop.
### Claude Code
bash
claude mcp add parserbee --scope user -e PARSERBEEAPIKEY=pkyourapikey -- 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": { "PARSERBEEAPIKEY": "pkyourapikey" }
### From a local copy
bash
git clone https://github.com/ParserBee/parserbee-mcp.git
cd parserbee-mcp
npm install
PARSERBEEAPIKEY=pkyourapikey node dist/index.js
Point your client at node /path/to/parserbee-mcp/dist/index.js.
## Settings
| Environment variable | Required | Use |
| PARSERBEEAPIKEY | Yes | Your API key from Settings |
| PARSERBEEBASEURL | No | Defaults to https://app.parserbee.com |
## What comes back
extractdocument returns the API response. The extracted fields are in data, shaped like your Parser Template:
json
"success": true,