FastOCR

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

Website · Docs · Get an API key

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."*

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

Tools

What you get back

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. Every account gets 50 free pages a month, shared with PDFs on the website; an image is one page. When you need more, buy a Page Pack on the pricing page. Packs and the page balance are the same on the website and in the API; ask your agent to run get_balance to see what is left. Accounts process 2 documents at once, or 10 with an API contract or 10,000 or more pages bought. 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 pricing page. Error codes are listed in the API docs.

Support and license

Questions: support@fastocr.org. Bugs and requests: GitHub issues. Python SDK: fastocr-python. MIT license; see LICENSE. Made by FastOCR.