Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Fastocr

FreeNot checked

MCP server for the FastOCR Document OCR API: OCR scanned PDFs into text or searchable PDFs from Claude, Cursor and other MCP clients.

GitHubEmbed

About

MCP server for the FastOCR Document OCR API: OCR scanned PDFs into text or searchable PDFs from Claude, Cursor and other MCP clients.

README

FastOCR

OCR any scanned PDF or image from Claude, Cursor and other MCP clients.

CI PyPI Python License: MIT

Website · Docs · Get an API key

FastOCR reads a scanned page in English, Arabic and Hindi and returns its text

An MCP server that lets your client OCR a local scanned PDF or image over stdio; files go only to the FastOCR API.

Quickstart

  1. Create an API key in the developer console.
  2. Add the server to Claude Code:
claude mcp add fastocr -e FASTOCR_API_KEY=your_api_key -- uvx fastocr-mcp
  1. Ask: "OCR ~/Scans/contract.pdf".

With uv there is nothing to install; the client runs uvx fastocr-mcp. Prefer pip? Run pip install fastocr-mcp and use the command fastocr-mcp. Python 3.10 or newer.

Other clients

Every client needs the same command, uvx fastocr-mcp, and your key in FASTOCR_API_KEY.

Claude Desktop

Add this to claude_desktop_config.json (Settings > Developer > Edit Config), then restart Claude Desktop:

{
  "mcpServers": {
    "fastocr": {
      "command": "uvx",
      "args": ["fastocr-mcp"],
      "env": { "FASTOCR_API_KEY": "your_api_key" }
    }
  }
}
Cursor

Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "fastocr": {
      "type": "stdio",
      "command": "uvx",
      "args": ["fastocr-mcp"],
      "env": { "FASTOCR_API_KEY": "your_api_key" }
    }
  }
}
VS Code

Add this to .vscode/mcp.json in your workspace. VS Code uses servers, not mcpServers:

{
  "servers": {
    "fastocr": {
      "type": "stdio",
      "command": "uvx",
      "args": ["fastocr-mcp"],
      "env": { "FASTOCR_API_KEY": "your_api_key" }
    }
  }
}

If you installed with pip, use "command": "fastocr-mcp" and "args": [].

Examples

Ask your client in plain language:

  • "OCR ~/Downloads/scanned-contract.pdf and summarize the termination clause."
  • "Read the text in /Users/me/Desktop/receipt.jpg."
  • "Make a searchable copy of /Users/me/archive/1998-letters.pdf."
  • "List my last five FastOCR documents."
An MCP client calls ocr_file on a scanned letter and gets back its text

The text above is the unedited output FastOCR returned for a scanned page.

Tools

Tool What it does
ocr_file(path, output="text", output_path=None) Uploads a local PDF or image, runs OCR and waits up to 45 seconds; a larger document returns its id for get_document. output="text" returns the text (text over 20,000 characters is cut, and the full text is saved to output_path or <file>.ocr.txt next to the input file). output="pdf" saves a searchable PDF to output_path or <file>.searchable.pdf.
ocr_pdf(path, output="text", output_path=None) The same tool as ocr_file under its earlier name, kept so existing setups keep working.
get_document(document_id, output="status", output_path=None) Status and page counts of a document; with output="text" or "pdf", waits up to 45 seconds and fetches the finished result. Fetching a result again costs no pages.
list_documents(limit=20) The most recent documents in the account, newest first.
delete_document(document_id) Deletes a document and its stored files on FastOCR. Local files are not touched.

What you get back

You get How
The text of the document ocr_file(path), or get_document(id, output="text")
A searchable PDF ocr_file(path, output="pdf"), saved beside the input
Status and page counts get_document(id)
Your recent documents list_documents()

Languages and files

  • 100+ languages, detected automatically. No language setting is needed.
  • PDF files up to 1 GiB, and PNG, JPG, JPEG, GIF, WebP and BMP images up to 20 MiB. An image counts as one page.
  • Built on the official fastocr-sdk and the official MCP Python SDK.

Pages and pricing

Any signed-in FastOCR account can create an API key and start right away. Each account gets 50 free document pages per month; an image is one page. When you need more, buy a prepaid API page pack by card in the developer console. You accept the API terms with your first key.

Errors and configuration

Tool errors are written for the agent to act on: a rejected key, an account out of pages (buy_pages), too many documents processing at once (concurrency_limit), a missing file, or an unsupported file type. Each message says what to do next. A document that runs out of pages fails with buy_pages; the tool says so and links to the developer console. Error codes are listed in the API docs.

Variable Purpose
FASTOCR_API_KEY Required. Your API key.
FASTOCR_BASE_URL Optional. Overrides https://api.fastocr.org.

Support and license

Questions: [email protected]. Bugs and requests: GitHub issues. Python SDK: fastocr-python. MIT license; see LICENSE. Made by FastOCR.

from github.com/fastocr-org/fastocr-mcp

Install Fastocr in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install fastocr

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add fastocr -- uvx fastocr-mcp

Step-by-step: how to install Fastocr

FAQ

Is Fastocr MCP free?

Yes, Fastocr MCP is free — one-click install via Unyly at no cost.

Does Fastocr need an API key?

No, Fastocr runs without API keys or environment variables.

Is Fastocr hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Fastocr in Claude Desktop, Claude Code or Cursor?

Open Fastocr on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Fastocr with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs