Skip to main content
MCP server CX Codex

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 GitHub

What 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.log in 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open