# FastOCR

> FastOCR is a freemium MCP server for files and documents. MCP server that OCRs local scanned PDFs and images and exports bank statements. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://fastocr.org/docs
- **Repository:** https://github.com/fastocr-org/fastocr-mcp
- **MCP Registry name:** io.github.fastocr-org/fastocr-mcp
- **Categories:** files and documents, finance and payments
- **Listing updated:** 2026-11-14

## About

FastOCR's server runs locally over stdio and uploads a file you point it at to the FastOCR API; the README says files go only there. It can return extracted text, save a searchable PDF, or check the status and page count of earlier documents. Output over 20,000 characters is cut in the reply and the full text saved beside the input as `<file>.ocr.txt`.

A beta tool, extract_bank_statement, turns digital bank statements (PDF, PNG, JPG or WebP) into xlsx, csv, json or accounting formats including qbo, QuickBooks csv, qfx and ofx, and reports whether each account's balance reconciles. The pricing page cautions the check is not a guarantee, and loan statements are refused without charge.

You need a FastOCR API key (FASTOCR_API_KEY) and Python 3.10 or newer, run with `uvx fastocr-mcp`. The Free plan gives 20 pages a month; Page Packs start at $4.99 for 500 pages, and the first 50 bank statement pages are free.

## Features

- **Local file OCR:** OCR a PDF or image path and return text or a searchable PDF.
- **Large document handling:** Waits up to 45 seconds, then returns an id to fetch later.
- **Bank statement export:** Beta extraction to Excel, CSV, JSON, QBO, QFX and OFX.
- **Balance reconciliation:** Reports whether account balances reconcile and flags needs_review.
- **Document history:** List recent documents and re-fetch results without new page charges.
- **Balance check:** See pages left on the account.

## Good for

- OCR a scanned contract and summarize a clause
- Make a scanned archive searchable
- Convert a bank statement to a QuickBooks file
- Read text from a receipt photo

## Install

### Claude Code (Terminal)

```sh
claude mcp add fastocr-mcp --env FASTOCR_API_KEY='<FASTOCR_API_KEY>' -- uvx fastocr-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "fastocr-mcp": {
      "command": "uvx",
      "args": [
        "fastocr-mcp"
      ],
      "env": {
        "FASTOCR_API_KEY": "<FASTOCR_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fastocr-mcp": {
      "command": "uvx",
      "args": [
        "fastocr-mcp"
      ],
      "env": {
        "FASTOCR_API_KEY": "<FASTOCR_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "fastocr-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "fastocr-mcp"
      ],
      "env": {
        "FASTOCR_API_KEY": "<FASTOCR_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fastocr-mcp": {
      "command": "uvx",
      "args": [
        "fastocr-mcp"
      ],
      "env": {
        "FASTOCR_API_KEY": "<FASTOCR_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fastocr-mcp": {
      "command": "uvx",
      "args": [
        "fastocr-mcp"
      ],
      "env": {
        "FASTOCR_API_KEY": "<FASTOCR_API_KEY>"
      }
    }
  }
}
```

## Tools

- `ocr_file`: Uploads a local PDF or image, runs OCR and returns text or a searchable PDF.
- `ocr_pdf`: Earlier name for ocr_file.
- `get_document`: Status and page counts of a document, or its finished result.
- `list_documents`: The most recent documents in the account.
- `extract_bank_statement`: Beta; exports a bank statement to xlsx, csv, json or accounting formats.
- `get_bank_statement`: Fetches a bank statement result that did not finish.
- `get_balance`: The pages left on the account.

## FAQ

### Do I need an API key?

Yes, FASTOCR_API_KEY from the developer console is required.

### What does it cost?

20 free pages a month, then Page Packs from $4.99 for 500 pages; bank statements use a separate pool with the first 50 pages free.

### What file sizes are accepted?

The API takes PDFs up to 1 GiB and images up to 20 MiB.

### Where do my files go?

The README says files go only to the FastOCR API.

### Is FastOCR free?

FastOCR has a free plan, with paid plans for more usage or features.

### How do I add FastOCR to Claude Code?

Run this command in your terminal: claude mcp add fastocr-mcp --env FASTOCR_API_KEY='<FASTOCR_API_KEY>' -- uvx fastocr-mcp

### What are the best alternatives to FastOCR?

The closest alternatives to FastOCR 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/fastocr
