Read PDFs and images with ocr-software.com: page count, job, text, Markdown, JSON, hOCR.
Connect Runs on your machine
claude mcp add ocr-software-mcp -e OCR_KEY=<OCR_KEY> -e OCR_BASE_URL=<OCR_BASE_URL> -e OCR_OUT_DIR=<OCR_OUT_DIR> -e OCR_ALLOWED_DIR=<OCR_ALLOWED_DIR> -- uvx ocr-software-mcp==0.3.1
{
"mcpServers": {
"ocr-software-mcp": {
"command": "uvx",
"args": [
"ocr-software-mcp==0.3.1"
],
"env": {
"OCR_KEY": "<OCR_KEY>",
"OCR_BASE_URL": "<OCR_BASE_URL>",
"OCR_OUT_DIR": "<OCR_OUT_DIR>",
"OCR_ALLOWED_DIR": "<OCR_ALLOWED_DIR>"
}
}
}
}
{
"mcpServers": {
"ocr-software-mcp": {
"command": "uvx",
"args": [
"ocr-software-mcp==0.3.1"
],
"env": {
"OCR_KEY": "<OCR_KEY>",
"OCR_BASE_URL": "<OCR_BASE_URL>",
"OCR_OUT_DIR": "<OCR_OUT_DIR>",
"OCR_ALLOWED_DIR": "<OCR_ALLOWED_DIR>"
}
}
}
}
{
"servers": {
"ocr-software-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"ocr-software-mcp==0.3.1"
],
"env": {
"OCR_KEY": "<OCR_KEY>",
"OCR_BASE_URL": "<OCR_BASE_URL>",
"OCR_OUT_DIR": "<OCR_OUT_DIR>",
"OCR_ALLOWED_DIR": "<OCR_ALLOWED_DIR>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
OCR_KEYRequired, secret | API key, starts with ocr_. Never shown to the model. |
OCR_BASE_URLOptional | Address of the service; for your own server e.g. http://127.0.0.1:8080. |
OCR_OUT_DIROptional | Folder where results are written. Default: ocr-results next to the document, else ~/Documents/ocr-results. |
OCR_ALLOWED_DIROptional | Optional: read documents only from below this folder. |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 14 Nov 2026 |
| Last updated | 14 Nov 2026 |
| Registry name | io.github.ocr-software/ocr-software-mcp |
More files and documents servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
