# Handwriting OCR

Handwriting OCR runs handwriting recognition on scans and PDFs, then hands the result back to your agent as Markdown.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: handwriting-ocr
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/handwriting-ocr/handwriting-ocr-mcp-server
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/handwriting-ocr

## What it does

Three tools show up in your client: one uploads a document, one reports how the job is going, one returns the text. Images and PDFs go in; Markdown comes out.

The hosted endpoint at `https://mcp.handwritingocr.com` is the shorter route. Sign-in runs through OAuth in the browser, so nothing gets pasted into a config file. That version also exports to Word, Excel and JSON, and its extractors pull named fields off a page. Stdio-only clients reach it through the `mcp-remote` proxy.

Keep the local Node.js build for offline work. It needs Node.js 18.x or higher plus an API token exposed as `API_TOKEN`. The sample config points at someone else's absolute path to `build/index.js` — swap in yours, or the client will fail to launch it.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- Turn a photographed page into editable text
- Pull named fields out of a scanned form
- OCR a multi-page PDF without opening the web dashboard
- Hand the transcript to the assistant as Markdown
- See how far a long document has got in the queue

## Example prompts
- Upload `receipt-scan.jpg` to Handwriting OCR and show me the text.
- Check the status of the document I sent and fetch the result.
- Export the finished transcription to Word next to the original file.

## Similar
- [deepseek-ocr](https://affpapa.org/en/nevibecode/skills/deepseek-ocr.md) — skill · 1600 installs
- [ocr](https://affpapa.org/en/nevibecode/skills/ocr.md) — skill · 509 installs
- [visual-analysis-ocr](https://affpapa.org/en/nevibecode/agents/visual-analysis-ocr.md) — subagent · 742 installs
- [ocr-quality-assurance](https://affpapa.org/en/nevibecode/agents/ocr-quality-assurance.md) — subagent · 573 installs
- [PDF OCR Extraction](https://affpapa.org/en/nevibecode/skills/pdf-ocr-extraction.md) — skill · 6000 installs
- [skill-ollama-deepseek-ocr-tool](https://affpapa.org/en/nevibecode/skills/skill-ollama-deepseek-ocr-tool.md) — skill · 1 install

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
