Mistral OCR MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "MISTRAL_API_KEY=${MISTRAL_API_KEY}" mistral-ocr -- uvx --from /path/to/mistral-ocr-mcp mistral-ocr-mcp
Required:MISTRAL_API_KEY
README.md

Perform OCR on local files using Mistral AI's document processing capabilities.

Mistral OCR MCP Server

A Model Context Protocol (MCP) server that enables Claude to perform OCR (Optical Character Recognition) on local files using Mistral AI's document processing capabilities.

Setup

  1. Get a Mistral API key from Mistral AI Console

  2. Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mistral-ocr": {
      "command": "uvx",
      "args": ["--from", "/path/to/mistral-ocr-mcp", "mistral-ocr-mcp"],
      "env": {
        "MISTRAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace /path/to/mistral-ocr-mcp with the actual path to this directory.

Usage

`ocr_local_file`

Process local files with OCR and convert to markdown format.

  • file_path: Path to the local file to process
  • output_path: Optional output path for markdown file (defaults to same name with .md extension)
  • include_image_base64: Whether to include base64 encoded images in response

Examples

Process this document with OCR: /path/to/document.pdf

Extract text from this image: /path/to/image.jpg

OCR this file and save to custom location: /path/to/input.png with output /path/to/output.md

Troubleshooting

  • API key error: Set MISTRAL_API_KEY in your environment
  • File not found: Check that the file path exists and is accessible
  • Unsupported format: Ensure the file is a supported image or document format
  • Rate limit: Wait and try again

Tools (1)

ocr_local_fileProcess local files with OCR and convert to markdown format.

Environment Variables

MISTRAL_API_KEYrequiredAPI key from Mistral AI Console

Configuration

claude_desktop_config.json
{"mcpServers": {"mistral-ocr": {"command": "uvx", "args": ["--from", "/path/to/mistral-ocr-mcp", "mistral-ocr-mcp"], "env": {"MISTRAL_API_KEY": "your_api_key_here"}}}}

Try it

Process this document with OCR: /path/to/document.pdf
Extract text from this image: /path/to/image.jpg
OCR this file and save to custom location: /path/to/input.png with output /path/to/output.md

Frequently Asked Questions

What are the key features of Mistral OCR?

Performs OCR on local files using Mistral AI. Converts documents and images into markdown format. Supports custom output paths for processed files. Optional inclusion of base64 encoded images in response.

What can I use Mistral OCR for?

Digitizing scanned paper documents for text analysis. Extracting text from images for use in markdown documentation. Converting complex PDF layouts into machine-readable markdown. Automating document ingestion workflows for Claude.

How do I install Mistral OCR?

Install Mistral OCR by running: uvx --from /path/to/mistral-ocr-mcp mistral-ocr-mcp

What MCP clients work with Mistral OCR?

Mistral OCR works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Mistral OCR docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare