Freezetext Mcp

What is Freezetext Mcp?

Freezetext Mcp is a Model Context Protocol server that lets AI assistants like Claude and Cursor OCR anything on the Mac screen by communicating with the FreezeText app’s local HTTP API. All text extraction runs locally via Apple Vision Framework – no cloud, no data transmission. It requires macOS 14+, the free FreezeText app installed and running with its API enabled, and Swift 5.9+ to build from source.

How to use Freezetext Mcp?

Install by building from source (swift build -c release) or downloading a pre-built binary from Releases. Configure your MCP client (e.g., Claude Desktop, Claude Code, or Cursor) to launch the binary with environment variables FREEZETEXT_API_PORT (default 9876) and optionally FREEZETEXT_API_TOKEN. Invoke tools like capture_screen, ocr_image, or search_history through the MCP client.

Key features of Freezetext Mcp

• 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.

Use cases of Freezetext Mcp

• Extract text from videos, disappearing popups, or protected PDFs using AI assistants.
• OCR a specific screen region and feed the result to Claude for summarization.
• Search past OCR history for tracking numbers or invoice data.
• Automate data extraction from screenshots inside Cursor or other MCP clients.
• Capture and copy text from hover tooltips that normally cannot be selected.

FAQ from Freezetext Mcp

What do I need to run this server?

You need macOS 14+, the free FreezeText app installed and running with its HTTP API enabled, and Swift 5.9+ if building from source. The app is available at the store link in the README.

How does OCR work? Is data sent to the cloud?

No, all OCR runs locally on your Mac via Apple Vision Framework. No data is transmitted to any cloud service.

Which MCP clients are supported?

Any MCP client that supports stdio transport, such as Claude Desktop, Claude Code, and Cursor.

How do I configure the API port and token?

Set the environment variable FREEZETEXT_API_PORT (default