fm-mcp — Claude Code MCP server: what it does, how to install
fm-mcp is an MCP server for Claude Code that hands text summaries, field extraction and classification to Apple’s on-device model. It can also read text from images.
MIT ★ 5 updated 2026-10-18
Open on GitHubWhat fm-mcp does
fm-mcp sends summarisation, field extraction, classification and image OCR tasks to Apple’s local model. The agent can pass text or a file path; extracted fields come back as JSON shaped by a supplied schema. OCR handles one PNG, JPEG, HEIC, TIFF, GIF or BMP image, not PDFs.
It requires an Apple Silicon Mac, macOS 27 with Apple Intelligence enabled, and an accepted fm licence (fm license). The small model is not intended for code, maths or reasoning, and its output can omit or distort details. Input and output share a context of about 8K tokens. Requests queue when multiple sessions use the model on the same Mac.
What it helps with
- condense a log or transcript into a short summary
- extract named fields from text as schema-shaped JSON
- sort text into labels chosen for the task
- read text from a supported image
Example prompts for the agent
- Summarise the log at
logs/app.login a few sentences. - Extract the order number and date from this text as JSON.
- Read the text in
receipt.png.
How to install fm-mcp
Install
The MCP registry has no launch command for it: see the repository README
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 fm-mcp
How do I install fm-mcp in Claude Code?
Install it with Homebrew: run brew install yrangana/tap/fm-mcp, then fm-mcp install. Start a new Claude Code session afterward.
What does fm-mcp do?
It delegates summarisation, field extraction, classification and image text recognition to Apple’s on-device model. Field extraction returns JSON shaped by a supplied schema.
What does fm-mcp need to run?
It needs an Apple Silicon Mac, macOS 27 with Apple Intelligence enabled, and an accepted fm licence. Accept the licence with fm license.