mistral-mcp

MCP server for Mistral AI — chat, OCR, audio (Voxtral), code (Codestral), vision, agents, batch, and durable workflows.Plug into Claude Code, Cursor, Zed, Windsurf, or Claude Desktop in one command.

mistral-mcpexposes the full Mistral AI API as a set of MCP tools, resources, and prompts. An MCP client (Claude Code, Cursor, etc.) can callmistral_ocrto extract text from a PDF,voxtral_transcribeto transcribe a meeting recording, orworkflow_executeto start a durable multi-step process — all without leaving the agent loop.

Unique to Mistral and not available from other MCP servers:

- mistral_ocr— Mistral Document AI: structured text + bbox annotations from any PDF or image
- voxtral_transcribe— Voxtral: transcription with optional speaker diarization
- codestral_fim— Codestral fill-in-the-middle (FIM) for inline code completion
- workflow_execute / status / interact— Temporal-backed durable execution with human-in-the-loop signals
- French-optimized models (mistral-large-latest,mistral-medium-latest) and curated French prompts

What this server does not expose:fine-tuning, user management, non-FR/EN prompts.

mistral-mcpis designed for teams that want to use Mistral capabilities inside MCP clients (Claude Code, Cursor, Zed, Windsurf, Claude Desktop) while keeping control over deployment, API keys, cache behavior, and tool exposure.

This can be useful for European organisations evaluating AI stacks under GDPR, DORA, sector-specific constraints (HDS, EBA), or internal sovereignty requirements.

- self-hosted MCP server, no mandatory SaaS proxy
- bring-your-own Mistral API key (BYOK) — Mistral states API data is not used to train its models
- leancoreprofile and focusedmetier-docsprofile to limit tool exposure
- process_documentcache configurable per-call and viaMISTRAL_MCP_CACHE_DIR
- ID document cache bypass enabled by default, even whenkind:"auto"resolves toid_document
- Streamable HTTP + bearer auth path for controlled / on-prem deployments
- French-first prompts and skills (meeting minutes, legal summary, invoice reminder, commit message, email reply)
- free Experiment tier on the Mistral side covers most evaluation needs (~1B tokens/month)

- it is not a GDPR, DORA, HDS, or ISO certification, and it does not replace a DPIA, vendor review, security audit, or legal assessment
- Mistral provider terms, data residency, subprocessor list, retention settings, and incident handling must be reviewed separately atmistral.ai/termsandlegal.mistral.ai
- this repo is community-maintained, not an official Mistral integration; nothing here modifies Mistral's contractual data terms with you

/plugin install mistral-mcp@swih-plugins

{ "mcpServers": { "mistral": { "command": "npx", "args": ["-y", "mistral-mcp@latest"], "env": { "MISTRAL_API_KEY": "your_key_here" } } } }

claude mcp add mistral -- npx -y mistral-mcp@latest

MISTRAL_MCP_PROFILEcontrols how many tools are exposed (default:core).

fullis accepted as a deprecated alias ofadminfor backward compatibility.

MISTRAL_MCP_PROFILE=admin npx mistral-mcp

Core profile (12 tools — always available)

Documents vertical (MISTRAL_MCP_PROFILE=metier-docs)

Admin profile only (+29 tools, setMISTRAL_MCP_PROFILE=admin)

Curated prompts with structured arguments and MCP completion support:

Install via theswih-pluginsmarketplace to get these namespaced skills:

- /mistral-mcp:mistral-router— picks the right Mistral model + tool for any task

- /mistral-mcp:codestral-review— fetches the current diff, runs a focused review

- /mistral-mcp:french-commit-message— Conventional Commits message in French
- /mistral-mcp:french-meeting-minutes— audio or text → structured French minutes
- /mistral-mcp:french-invoice-reminder— B2B dunning letter with controlled tone

- /mistral-mcp:contract-analyzer— OCR → risk-rated clause extraction (JSON)
- /mistral-mcp:pdf-invoice-extractor— OCR → structured invoice fields for reconciliation
- /mistral-mcp:audio-dispatch— transcribe + diarize → per-speaker action plan

- /mistral-mcp:contract-review-workflow— durable contract review with approval gates
- /mistral-mcp:compliance-audit-workflow— multi-step audit with mid-run findings + decisions
- /mistral-mcp:research-pipeline-workflow— hypothesis-driven research with amendment injection

# Run directly (no global install) npx mistral-mcp # Global install npm install -g mistral-mcp && mistral-mcp # Docker docker build -t mistral-mcp . docker run -i --rm -e MISTRAL_API_KEY=your_key mistral-mcp # From source git clone https://github.com/Swih/mistral-mcp.git cd mistral-mcp && npm install && npm run build node dist/index.js

HTTP env vars:MCP_HTTP_HOST,MCP_HTTP_PORT,MCP_HTTP_PATH,MCP_HTTP_TOKEN(bearer auth),MCP_HTTP_ALLOWED_ORIGINS,MCP_HTTP_STATELESS=1.

/healthzis public and does not touch the MCP server.

mistral-mcpships theStreamable HTTP transportand bearer auth thatMistral Connectorsrequire. Deployment guides for Cloudflare Tunnel, Fly.io, and Render are inexamples/deploy/README.md.

curl -X POST https://api.mistral.ai/v1/connectors \ -H "Authorization: Bearer $MISTRAL_API_KEY" \ -d '{"name":"mistral_self","server":"https://your-deploy/mcp","visibility":"private"}'

npm run dev # tsx watch npm run build # tsc → dist/ npm run lint # tsc --noEmit npm test # 190+ tests (unit + contract + stdio e2e + live API) npm run inspector

AI-powered semantic search over React documentation for Claude, Cursor, and other MCP clients.