# Parserbee MCP

> Parserbee MCP is an MCP server for files and documents. Extract fields from invoices, receipts and other documents using your ParserBee templates. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, CLI
- **Website:** https://parserbee.com
- **Repository:** https://github.com/parserbee/parserbee-mcp
- **MCP Registry name:** io.github.ParserBee/parserbee-mcp
- **Categories:** files and documents, finance and payments
- **Listing updated:** 2026-11-15

## About

This server wraps the ParserBee API, so an assistant can read a local file or a public link and return data shaped like one of your Parser Templates. Files can be PDF, PNG, JPG, WebP or HEIC up to 50 MB, and scans and phone photos work. Each page parsed costs one page credit.

A template defines the fields you want, for example vendor name, invoice number, line items and total, and one invoice template reads invoices from any supplier layout. Create it by uploading a sample document or pick one from the ready-made library. The response carries the extracted `data`, remaining credits and pages processed. Errors such as an invalid key or no credits left come back as tool errors with the ParserBee code.

You need Node.js 18 or later and an API key from the dashboard settings. The authors also publish a sample-invoices repository with 18 test invoices and the correct value of every field.

## Features

- **Extract from a file or link:** Parse a local path or public URL with a chosen template.
- **Template listing:** See your templates and their fields.
- **Credit check:** Read page credit balance, plan and subscription status.
- **Extraction history:** Review the last 10 requests and fetch one with its data.
- **Wide file support:** Handles PDF, PNG, JPG, WebP and HEIC up to 50 MB.

## Good for

- Pull totals and due dates from a folder of invoices
- Turn receipts into a table of merchant, date and total
- Check page credits before a batch run
- Re-read an earlier extraction by its request id

## Install

### Claude Code (Terminal)

```sh
claude mcp add parserbee-mcp --env PARSERBEE_API_KEY='<PARSERBEE_API_KEY>' -- npx -y parserbee-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "parserbee-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "parserbee-mcp"
      ],
      "env": {
        "PARSERBEE_API_KEY": "<PARSERBEE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `extract_document`: Extract data from a local file or public link 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

## FAQ

### What do I need to start?

A ParserBee account, a Parser Template and an API key from Settings; new accounts get 25 free pages with no card.

### How are pages counted?

One page credit per page parsed, so a three-page invoice uses three.

### What file types work?

PDF, PNG, JPG, WebP and HEIC up to 50 MB.

### Does it run locally?

It runs over stdio via npx and calls the ParserBee API using your key.

### Is Parserbee MCP free?

Parserbee MCP is a paid product with a free trial.

### How do I add Parserbee MCP to Claude Code?

Run this command in your terminal: claude mcp add parserbee-mcp --env PARSERBEE_API_KEY='<PARSERBEE_API_KEY>' -- npx -y parserbee-mcp

### What are the best alternatives to Parserbee MCP?

The closest alternatives to Parserbee MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, ASTra and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/parserbee-mcp
