Freezetext Mcp
About
# FreezeText MCP Server [](https://swift.org) [](https://apple.com/macos) [](LICENSE)…
Explore
- 12 tools covering capture & OCR, history, and language configuration.
- 100% local OCR – no data leaves your Mac.
- Compatible with any MCP client using stdio transport.
- Screen freeze, region capture, and base64 image OCR.
- Full history management with search and JSON/CSV export.
- Configurable OCR languages via get_ocr_languages and set_ocr_languages.
1. macOS 14 (Sonoma) or later
2. FreezeText app installed and running — get it free here — with the HTTP API enabled in Settings
3. Swift 5.9+ (Xcode 15+) if building from source
| Variable | Default | Description |
|---|---|---|
| FREEZETEXT_API_PORT | 9876 | Port of FreezeText's local HTTP API |
| FREEZETEXT_API_TOKEN | _(none)_ | Bearer token — only if set in FreezeText Settings |
---
OCR anything on your Mac screen from Claude, Cursor, or any MCP client.
This is the official Model Context Protocol server for FreezeText — a free native macOS app that freezes the screen and extracts text via Apple Vision OCR. Whether running videos, disappearing popups, protected PDFs, or hover tooltips — FreezeText makes any visible text copyable.
> You need the FreezeText app installed and running with its HTTP API enabled (Settings → API). This MCP server talks to the app's local API. Get FreezeText (free) at store.juergenkoller.software/apps/freezetext.
---
What you can do
> "Claude, OCR whatever is on my screen right now and summarize it."
>
> "Cursor, run OCR on this screenshot (base64) and extract the invoice number."
>
> "Search my FreezeText history for everything containing 'tracking number'."
The MCP server exposes 12 tools:
| Category | Tools |
|---|---|
| Capture & OCR | capture_screen (freeze + OCR), capture_region (OCR a specific rect), ocr_image (OCR a base64 image) |
| History | list_history, search_history, get_history_entry, add_history, delete_history_entry, clear_history, export_history (JSON/CSV) |
| OCR config | get_ocr_languages, set_ocr_languages |
All OCR runs locally via Apple Vision Framework — no cloud, no data transmission.
---
Installation
Prerequisites
1. macOS 14 (Sonoma) or later
2. FreezeText app installed and running — get it free here — with the HTTP API enabled in Settings
3. Swift 5.9+ (Xcode 15+) if building from source
Build from source
```bash
git clone https://github.com/juergenkoller-software/freezetext-mcp.git
cd freezetext-mcp
swift build -c release
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
