Extract structured data from invoices, receipts, and other documents using custom Parser Templates.
También conocido como ParserBee/parserbee-mcp
- Stars
- 0
- Herramientas
- 6
- Descargas, 30 días
- —
- Última versión
- 0.1.1
- Último commit
- 18 oct 2026
- Licencia
- MIT
¿Qué es ParserBee MCP?
ParserBee es un MCP server. Extract structured data from invoices, receipts, and other documents using custom Parser Templates. Expone 6 herramientas, como extract_document, list_templates, get_template.
Resumen generado a partir del README del proyecto
Acerca del MCP server de ParserBee
ParserBee MCP allows AI assistants to transform unstructured documents like invoices, receipts, purchase orders, and bank statements into organized data. Users connect this server to clients such as Claude Desktop, Claude Code, Cursor, or VS Code by providing a ParserBee API key starting with pk_. The server runs locally via npx or a local Node.js installation and communicates with the ParserBee service to process files.
Developers use specific tools to manage their workflow. The extract_document tool processes local files or public links using custom Parser Templates, consuming one page credit per page. Other available tools include list_templates to view account templates, get_credits to check remaining page balances, and list_recent_extractions to review the last 10 requests. The system supports various file formats including PDF, PNG, JPG, WebP, and HEIC up to 50 MB in size.
Qué puedes hacer con él
- 1Extract data from specific filesAsk your assistant to pull information from a local PDF using a predefined template.
- 2Batch process document foldersInstruct the AI to read multiple receipts in a directory and organize the details into a table.
- 3Monitor account usageCheck how many page credits remain in your ParserBee account.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar ParserBee MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar ParserBee MCP en Claude Code
$ claude mcp add --env 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' parserbee-mcp -- npx -y parserbee-mcpInstalar ParserBee MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"parserbee-mcp": {
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}Instalar ParserBee MCP en VS Code
.vscode/mcp.json
{
"servers": {
"parserbee-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}Instalar ParserBee MCP en VS Code CLI
$ code --add-mcp '{"name":"parserbee-mcp","type":"stdio","command":"npx","args":["-y","parserbee-mcp"],"env":{"PARSERBEE_API_KEY":"<YOUR_PARSERBEE_API_KEY>"}}'Instalar ParserBee MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"parserbee-mcp": {
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}Instalar ParserBee MCP en Codex
$ codex mcp add parserbee-mcp --env 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' -- npx -y parserbee-mcpInstalar ParserBee MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.parserbee-mcp] command = "npx" args = ["-y", "parserbee-mcp"] [mcp_servers.parserbee-mcp.env] PARSERBEE_API_KEY = "<YOUR_PARSERBEE_API_KEY>"
Instalar ParserBee MCP en Gemini CLI
$ gemini mcp add -s user -e 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' parserbee-mcp npx -- -y parserbee-mcpInstalar ParserBee MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"parserbee-mcp": {
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}Herramientas de ParserBee MCP 6
Detectado desde el READMEextract_documentlist_templatesget_templateget_creditslist_recent_extractionsget_extraction
| extract_document | — | |
| list_templates | — | |
| get_template | — | |
| get_credits | — | |
| list_recent_extractions | — | |
| get_extraction | — |
Configuración
PARSERBEE_API_KEYObligatorioSecretoYour ParserBee API key, from Settings in the dashboard
| Nombre | Descripción | Tipo |
|---|---|---|
| PARSERBEE_API_KEY | Your ParserBee API key, from Settings in the dashboard | ObligatorioSecreto |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en GitHubParserBee MCP server
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 |
|---|---|
extract_document |
Extract data from a local file (file_path) or a public link (file_url) with a Parser Template. 1 page credit per page. |
list_templates |
List the Parser Templates in your account, with their fields |
get_template |
One Parser Template with all of its fields |
get_credits |
Page credit balance, plan and subscription status |
list_recent_extractions |
The last 10 extraction requests |
get_extraction |
One extraction request, with its extracted data |
Before you start
- Create a free account at app.parserbee.com. New accounts get 25 free pages, no credit card.
- 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.
- 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:
{
"mcpServers": {
"parserbee": {
"command": "npx",
"args": ["-y", "parserbee-mcp"],
"env": { "PARSERBEE_API_KEY": "pk_your_api_key" }
}
}
}
Restart Claude Desktop.
Claude Code
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:
{
"servers": {
"parserbee": {
"command": "npx",
"args": ["-y", "parserbee-mcp"],
"env": { "PARSERBEE_API_KEY": "pk_your_api_key" }
}
}
}
From a local copy
git clone https://github.com/ParserBee/parserbee-mcp.git
cd parserbee-mcp
npm install
PARSERBEE_API_KEY=pk_your_api_key node dist/index.js
Point your client at node /path/to/parserbee-mcp/dist/index.js.
Settings
| Environment variable | Required | Use |
|---|---|---|
PARSERBEE_API_KEY |
Yes | Your API key from Settings |
PARSERBEE_BASE_URL |
No | Defaults 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:
{
"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
- parserbee-python and parserbee-node: client libraries
- parserbee-n8n: n8n workflows
- parserbee-postman: Postman collection and OpenAPI file
- Free browser tools: invoice parser, bank statement converter, receipt scanner
- Comparing tools? See our test of invoice OCR software.
Development
npm install
npm test
npm run build
License
MIT
Preguntas sobre ParserBee MCP
¿Cómo agrego ParserBee MCP a Claude Code?
Ejecuta claude mcp add --env 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' parserbee-mcp -- npx -y parserbee-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego ParserBee MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona ParserBee MCP?
Expone 6 herramientas, incluidas extract_document, list_templates, get_template, get_credits, list_recent_extractions.
How much does extraction cost?
Extraction costs 1 page credit per page processed.
What file formats are supported?
You can upload PDF, PNG, JPG, WebP, or HEIC files up to 50 MB.
Can I use my own templates?
Yes, the server allows you to extract data using your own Parser Templates.