[Integrations](https://spiral.ai/integrations) › [Raycast](https://spiral.ai/integrations/raycast) › [Mistral document OCR](https://spiral.ai/integrations/raycast/mistral-document-ocr)

# How to Use Mistral document OCR in Raycast

Mistral document OCR extracts text, tables, and embedded images from PDFs and images, with optional structured JSON annotations. Use it to turn reports and scanned documents into content an agent can search, compare, or analyze.

|  |  |
| --- | --- |
| Model | Mistral document OCR |
| Available through | Mistral |
| Category | Data |
| Price | $0.0026 per page ($0.0039 with document or bounding-box annotations). |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Mistral document OCR in Raycast

- Use Mistral document OCR on Apple's 2024 annual report PDF, extract its consolidated statements of operations, and explain the table's rows and year headings.
- Use Mistral document OCR on https://arxiv.org/pdf/2310.06825 and summarize the Mistral 7B paper's methods from the extracted text.
- Use Mistral document OCR on https://arxiv.org/pdf/1706.03762 and show me the extracted results tables before explaining them.
- Use Mistral document OCR on https://upload.wikimedia.org/wikipedia/foundation/f/f6/WMF_Mid-Year-Financials_08-09-FINAL.pdf and turn its financial tables into a readable comparison.
- Use Mistral document OCR on the first eight pages of Microsoft's 2024 annual report PDF and return its title, reporting period, and summary as structured data.

## How to set up Mistral document OCR in Raycast

Pick the way that suits you. Each takes about two minutes.

### Use the Raycast connector

1. **Install the server**: In Raycast run Install MCP Server. Name it Spiral, set Transport to HTTP, paste this URL and keep OAuth Type on Dynamic:

```text
https://api.spiral.ai/mcp
```

2. **Sign in to Spiral and approve**: Spiral opens in your browser: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Raycast never sees it, and you can remove it under Settings › Connected apps in the console.

### Use the Spiral skill

1. **Send Raycast this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Mistral document OCR**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "mistral",
    "model": "mistral-ocr-3",
    "input": {
      "document": {
        "document_url": "<document_url>"
      }
    }
  }'
```

Then paste one of the prompts above: Raycast finds Mistral document OCR on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/raycast

## Mistral document OCR tools and prices

- [Mistral OCR 3](https://spiral.ai/tools/mistral/mistral-ocr-3) (Mistral): $0.0026 per page ($0.0039 with document or bounding-box annotations).

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| pages |  | — | Specific pages to process. Accepts a list of integers or a string of comma-separated numbers and ranges (e.g. '0,1,2' or '0-5' or '0,2-4'). Page numbers start from 0. |
| image_limit |  | — | Max images to extract |
| table_format | markdown, html | — |  |
| extract_footer |  | false | Extract the page footer into the response's `footer` field and remove it from the markdown content |
| extract_header |  | false | Extract the page header into the response's `header` field and remove it from the markdown content |
| image_min_size |  | — | Minimum height and width of image to extract |

## What can you do with Mistral document OCR in Raycast?

Get readable text and usable tables from a public report PDF. A chat app can use the extracted content to explain a financial statement or summarize a research paper's methods.

### Make annual reports searchable

Extract report text into Markdown for a company research index, then use it to find business segments, risks, and accounting notes.

### Recover financial tables

Extract tables from public company reports for spreadsheet analysis. Preserve merged headers so year labels stay associated with the right figures.

### Prepare research papers for analysis

Turn paper PDFs into extracted text and images that an agent can use to summarize methods, compare results, and inspect figures.

### Compare public document revisions

Extract two editions of a government report or business publication, then compare the text and tables to identify changes.

### Build a report metadata catalog

Use structured annotations to collect document titles, reporting periods, and summaries in a consistent JSON structure. Process long reports in sections of up to eight pages.

### Describe figures for document search

Annotate extracted charts and figures with descriptions that help users find the relevant visual inside a collection of public reports.

## Overview

- [Mistral](https://spiral.ai/providers/mistral)
- [All Raycast guides](https://spiral.ai/integrations/raycast)

## Mistral document OCR in other agents

- [Amp](https://spiral.ai/integrations/amp/mistral-document-ocr)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/mistral-document-ocr)
- [Claude](https://spiral.ai/integrations/claude-desktop/mistral-document-ocr)
- [Claude Code](https://spiral.ai/integrations/claude-code/mistral-document-ocr)
- [Cline](https://spiral.ai/integrations/cline/mistral-document-ocr)
- [Codex](https://spiral.ai/integrations/codex/mistral-document-ocr)
- [Cursor](https://spiral.ai/integrations/cursor/mistral-document-ocr)
- [Devin](https://spiral.ai/integrations/devin/mistral-document-ocr)
- [dots](https://spiral.ai/integrations/dots/mistral-document-ocr)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/mistral-document-ocr)
- [Gemini](https://spiral.ai/integrations/gemini/mistral-document-ocr)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/mistral-document-ocr)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/mistral-document-ocr)
- [goose](https://spiral.ai/integrations/goose/mistral-document-ocr)
- [Grok](https://spiral.ai/integrations/grok/mistral-document-ocr)
- [Grok Build](https://spiral.ai/integrations/grok-build/mistral-document-ocr)
- [Hermes](https://spiral.ai/integrations/hermes/mistral-document-ocr)
- [Instinct](https://spiral.ai/integrations/instinct/mistral-document-ocr)
- [Manus](https://spiral.ai/integrations/manus/mistral-document-ocr)
- [Muse](https://spiral.ai/integrations/muse/mistral-document-ocr)
- [Muse Code](https://spiral.ai/integrations/muse-code/mistral-document-ocr)
- [n8n](https://spiral.ai/integrations/n8n/mistral-document-ocr)
- [Notion](https://spiral.ai/integrations/notion/mistral-document-ocr)
- [OpenClaw](https://spiral.ai/integrations/openclaw/mistral-document-ocr)
- [opencode](https://spiral.ai/integrations/opencode/mistral-document-ocr)
- [Perplexity](https://spiral.ai/integrations/perplexity/mistral-document-ocr)
- [VS Code](https://spiral.ai/integrations/vscode/mistral-document-ocr)
- [Windsurf](https://spiral.ai/integrations/windsurf/mistral-document-ocr)
- [Zapier](https://spiral.ai/integrations/zapier/mistral-document-ocr)

## More Raycast guides

- [Mistral OCR document extraction](https://spiral.ai/integrations/raycast/mistral-ocr-document-extraction)
- [Mistral document text and table extraction](https://spiral.ai/integrations/raycast/mistral-document-text-and-table-extraction)
- [Mistral OCR 4.1](https://spiral.ai/integrations/raycast/mistral-ocr-4-1)
- [Mistral document text extraction](https://spiral.ai/integrations/raycast/mistral-document-text-extraction)
- [GitHub user repositories](https://spiral.ai/integrations/raycast/github-user-repositories)
- [Moondream 2 object bounding boxes](https://spiral.ai/integrations/raycast/moondream-2-object-bounding-boxes)

## Questions about Mistral document OCR in Raycast

**Can Raycast use Mistral document OCR?**

Yes. Add Spiral to Raycast as an MCP server, and Raycast can find and run Mistral document OCR like any built-in tool.

**How much does Mistral document OCR cost in Raycast?**

$0.0026 per page ($0.0039 with document or bounding-box annotations). You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Raycast plan is separate.

**Do I need a Mistral account to use Mistral document OCR in Raycast?**

No. Spiral runs Mistral document OCR on its own Mistral account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Mistral document OCR in Raycast?**

About two minutes: install the server, then sign in to Spiral and approve.

**Does Raycast wait while Mistral document OCR runs?**

Mistral document OCR runs in the background. Raycast starts the run, checks on it and gives you the json when it's ready.

**Where does the extracted information come from, and how current is it?**

Mistral extracts content from the PDF or image supplied for processing. Its information reflects that document, so processing an older annual report gives you that report's contents.

**Can Mistral preserve complex tables?**

OCR 3 supports reconstructed tables with merged cells, multi-row blocks, and hierarchical column headers. HTML output can represent cells spanning multiple rows or columns.

**How much of a document can structured annotations cover?**

Mistral's cookbook documents an eight-page limit for document annotations and recommends splitting longer documents. The annotation stage receives OCR text plus the first eight extracted image bounding boxes.

**Does the reported 74% benchmark mean 74% transcription accuracy?**

No. Mistral reports a 74% overall win rate against OCR 2 across forms, scans, complex tables, and handwriting; that measures comparative wins rather than the percentage of characters transcribed correctly.

**Does OCR 3 return paragraph bounding boxes?**

Paragraph-level block extraction requires OCR 4 or newer. Mistral says older models accept the option but return an empty array, so OCR 3 should not be used when paragraph coordinates are required.

