mistral-mcp — Claude Code MCP server: what it does, how to install
Extracts structured data from invoices, contracts, and PDFs into validated JSON using Mistral models. Built for document processing in MCP clients.
claude mcp add --env MISTRAL_API_KEY=<MISTRAL_API_KEY> --env MISTRAL_BASE_URL=<MISTRAL_BASE_URL> --env MISTRAL_MCP_PROFILE=<MISTRAL_MCP_PROFILE> --env MISTRAL_DEFAULT_MODEL=<MISTRAL_DEFAULT_MODEL> --transport stdio mistral-mcp -- npx -y mistral-mcpWhat mistral-mcp does
The server connects Mistral APIs to MCP clients to parse incoming text, Markdown, or scanned files. Its primary tool, process_document, extracts vendor names, line items, totals, and due dates directly into JSON. Images and PDF files travel through Mistral OCR.
The default core profile registers six tools, covering document parsing, chat, vision, code generation, and audio transcription. Switching MISTRAL_MCP_PROFILE unlocks alternative toolsets, including metier-docs, orchestration workflows, or an admin setup with 46 tools. A self-hosted profile handles custom endpoints.
Schema validation guarantees data types and structure, but it does not verify invoice math, taxes, or factual correctness. Running the server requires Node.js 20+, a valid Mistral API key with sufficient quota, and text payloads under 60,000 UTF-16 code units.
What it helps with
- convert raw Markdown or text invoices into typed JSON
- extract tables and fields from scanned PDF files via OCR
- classify incoming contracts or identity records automatically
- access Mistral vision, chat, and transcription tools inside an MCP client
Example prompts for the agent
- Extract the vendor name, total, and line items from
invoice.mdinto JSON - Process the PDF receipt
receipt.pdfusingprocess_document - Identify the document type in
agreement.txtand return its parsed fields
How to install mistral-mcp
Platform CLI
claude mcp add --env MISTRAL_API_KEY=<MISTRAL_API_KEY> --env MISTRAL_BASE_URL=<MISTRAL_BASE_URL> --env MISTRAL_MCP_PROFILE=<MISTRAL_MCP_PROFILE> --env MISTRAL_DEFAULT_MODEL=<MISTRAL_DEFAULT_MODEL> --transport stdio mistral-mcp -- npx -y mistral-mcpReplace <…> with your own values
Platform CLI
codex mcp add mistral-mcp --env MISTRAL_API_KEY=<MISTRAL_API_KEY> --env MISTRAL_BASE_URL=<MISTRAL_BASE_URL> --env MISTRAL_MCP_PROFILE=<MISTRAL_MCP_PROFILE> --env MISTRAL_DEFAULT_MODEL=<MISTRAL_DEFAULT_MODEL> -- npx -y mistral-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mistral-mcp": {
"command": "npx",
"args": [
"-y",
"mistral-mcp"
],
"env": {
"MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
"MISTRAL_BASE_URL": "<MISTRAL_BASE_URL>",
"MISTRAL_MCP_PROFILE": "<MISTRAL_MCP_PROFILE>",
"MISTRAL_DEFAULT_MODEL": "<MISTRAL_DEFAULT_MODEL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mistral-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mistral-mcp"
],
"env": {
"MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
"MISTRAL_BASE_URL": "<MISTRAL_BASE_URL>",
"MISTRAL_MCP_PROFILE": "<MISTRAL_MCP_PROFILE>",
"MISTRAL_DEFAULT_MODEL": "<MISTRAL_DEFAULT_MODEL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MISTRAL_API_KEY=<MISTRAL_API_KEY> -e MISTRAL_BASE_URL=<MISTRAL_BASE_URL> -e MISTRAL_MCP_PROFILE=<MISTRAL_MCP_PROFILE> -e MISTRAL_DEFAULT_MODEL=<MISTRAL_DEFAULT_MODEL> mistral-mcp npx -y mistral-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mistral-mcp
How do I install mistral-mcp in Claude Code?
Run claude mcp add mistral-mcp -e MISTRAL_API_KEY=<MISTRAL_API_KEY> -- npx -y mistral-mcp in your terminal. Replace <MISTRAL_API_KEY> with your active Mistral key.
What does mistral-mcp do?
It connects MCP clients to Mistral models to turn invoices and text documents into structured JSON. In the default configuration, it also provides tools for vision, audio transcription, and chat.
Does mistral-mcp verify invoice math and accounting accuracy?
No, schema validation only checks field names and data types in the JSON response. You need to inspect totals, tax rates, and calculations against the original file.
