MCP Mistral OCR

v1.0.0Search & Data Extractionstable

OCR images or pdfs, locally or by URLs by using Mistral OCR API (paid)

mcp-mistral-ocrmcpai-integration
Share:
37
Stars
0
Downloads
0
Weekly
0/5

What is MCP Mistral OCR?

MCP Mistral OCR is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ocr images or pdfs, locally or by urls by using mistral ocr api (paid)

OCR images or pdfs, locally or by URLs by using Mistral OCR API (paid)

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • OCR images or pdfs, locally or by URLs by using Mistral OCR

Use Cases

Extract text from images or PDFs using Mistral OCR API (paid). Support both local files and URLs.
everaldo

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedApr 28, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-mistral-ocr

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP Mistral OCR

MCP Mistral OCR is a Model Context Protocol server that wraps Mistral AI's OCR API, enabling AI assistants to extract text from images and PDFs — whether stored locally or referenced by URL — without leaving the conversation. It exposes two tools: one for processing files from a configured local directory and another for fetching and processing remote files by URL. Developers and analysts who need to extract structured text from scanned documents, screenshots, or PDF reports can use this server to automate that extraction step directly within Claude or other MCP clients.

Prerequisites

  • Python 3.10 or later, or Docker
  • Mistral AI account with OCR API access and a paid API plan
  • MISTRAL_API_KEY from the Mistral AI console
  • A local directory for OCR_DIR where local files to be processed are stored
  • An MCP-compatible client such as Claude Desktop
1

Obtain a Mistral AI API key

Log into the Mistral AI console at console.mistral.ai, create a new API key, and note that the OCR API requires a paid plan.

2

Install via Smithery (recommended)

The easiest installation path uses Smithery, which handles configuration automatically for Claude Desktop.

npx -y @smithery/cli install @everaldo/mcp/mistral-crosswalk --client claude
3

Set environment variables

Set your Mistral API key and the directory where local files to be OCR'd will be placed.

export MISTRAL_API_KEY=your-mistral-api-key
export OCR_DIR=/path/to/your/ocr/input/directory
4

Place files to process in OCR_DIR

Copy or move the images or PDFs you want to process into the OCR_DIR directory. Supported formats are JPG, PNG, GIF, WebP, and PDF, with a 50 MB size limit and 1000-page maximum per file.

cp /path/to/document.pdf /path/to/your/ocr/input/directory/
5

Configure your MCP client

If not using Smithery, add the server manually to your claude_desktop_config.json with the environment variables set.

MCP Mistral OCR Examples

Client configuration

Manual claude_desktop_config.json configuration for the Mistral OCR MCP server using uvx.

{
  "mcpServers": {
    "mcp-mistral-ocr": {
      "command": "uvx",
      "args": ["mcp-mistral-ocr"],
      "env": {
        "MISTRAL_API_KEY": "your-mistral-api-key",
        "OCR_DIR": "/path/to/ocr/directory"
      }
    }
  }
}

Prompts to try

Once connected, use these prompts to extract text from local files and remote URLs.

- "Extract the text from invoice.pdf in my OCR directory"
- "Process the image at https://example.com/receipt.jpg and extract all line items"
- "Read the scanned contract at https://example.com/contract.pdf and summarize its key terms"
- "Extract all text from screenshot.png and format it as a table"

Troubleshooting MCP Mistral OCR

API authentication error when calling OCR tools

Verify that MISTRAL_API_KEY is set correctly and that your Mistral account has an active paid plan with OCR API access enabled. Free tier accounts cannot use the OCR API.

process_local_file tool cannot find the file

Ensure the file is placed in the directory specified by OCR_DIR and that you pass only the filename (not a full path) to the tool. The server maps this directory to /data/ocr in containerized setups.

Large PDF fails to process

Mistral OCR has a 50 MB file size limit and a 1000-page maximum. Split large PDFs into smaller chunks before processing, or process page ranges separately.

Frequently Asked Questions about MCP Mistral OCR

What is MCP Mistral OCR?

MCP Mistral OCR is a Model Context Protocol (MCP) server that ocr images or pdfs, locally or by urls by using mistral ocr api (paid) It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP Mistral OCR?

Follow the installation instructions on the MCP Mistral OCR GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP Mistral OCR?

MCP Mistral OCR works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP Mistral OCR free to use?

Yes, MCP Mistral OCR is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-mistral-ocr": { "command": "npx", "args": ["-y", "mcp-mistral-ocr"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP Mistral OCR?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides