Macos Vision MCP server

Read from the package source without running it. The installed server may list more.

• analyze_documentwrite action

  Run a full analysis pipeline on a local image or PDF and return structured JSON for document reconstruction: OCR (with line/paragraph grouping in reading order), face detection, barcode/QR detection, and rectangle detection — all in parallel, fully offline, no API key needed. USE WHEN: The user wants the model to reconstruct a document into Markdown, HTML, DOCX, or any other format — invoices, sca

• assert_text

  Assert that text is present on (or absent from) the screen, a window, or a pre-captured image — a local pass/fail verdict computed on this machine. The deterministic check runs here; no screenshot and no OCR dump needs to reach a cloud model for a UI test to pass. USE WHEN: Verifying UI state after an action: "the dialog says Saved", "the error banner is gone", "all three menu items are visible".

• capture_screen

  Take a screenshot locally — of the main display, a specific window, an app's frontmost window, or a screen region. The image is saved to disk and NEVER returned to the model: you get back the file path plus geometry, so follow-up OCR/assertion tools can map results to screen coordinates. USE WHEN: Starting any UI check. Then chain: read_screen_text / find_element / assert_text on the returned path

• classify_image

  Classify the content of a local image into categories using Apple Vision (offline, no API key needed). USE WHEN: The user wants to know what is depicted in an image — objects, scenes, activities, animals, food, etc. Works with 1000+ categories and returns confidence scores. DO NOT USE for: text extraction (use ocr_image), face/barcode detection (dedicated tools), images that need detailed visual d

• detect_barcodes

  Detect and decode barcodes or QR codes in a local image file using Apple Vision (offline, no API key needed). USE WHEN: The user wants to read a QR code, barcode, EAN, UPC, Code128, PDF417, Aztec, DataMatrix or other 1D/2D code from a local file. DO NOT USE for: text extraction (use ocr_image), face detection (use detect_faces). Supported symbologies: QR, EAN-8, EAN-13, UPC-E, Code39, Code93, Code

• detect_document

  Detect the boundary of a document in a local image using Apple Vision (offline, no API key needed). USE WHEN: The user has a photo of a piece of paper, a receipt, a card, an ID, or any rectangular document and wants the four corner points — typically as a hint for cropping, deskewing, or straightening the image before further OCR. DO NOT USE for: reading the document text (use ocr_image), classify

• detect_faces

  Detect human faces in a local image file using Apple Vision (offline, no API key needed). USE WHEN: The user wants to know how many faces are in a local image, or needs their positions. DO NOT USE for: text extraction (use ocr_image), barcode reading (use detect_barcodes). Returns: JSON with the total face count and an array of face positions expressed as percentage of image dimensions (top, left,

• find_element

  Find a UI element by its visible text and return WHERE TO CLICK — center coordinates in global screen points, ready to hand to any input driver (macos-mcp Click, cliclick, CGEvent). Capture, OCR, and matching all run locally; no screenshot is ever sent to the model or the cloud. USE WHEN: An agent needs to click/interact with something it can name ("click Save", "focus the search field") — this re

• list_windows

  List on-screen application windows with their global screen-point bounds — front-to-back order (first window of an app = its frontmost one). USE WHEN: You need a windowId for capture_screen / find_element, or want to know what apps are visible before testing their UI. Returns: JSON { titlesAvailable, note?, windows: [{ windowId, app, pid, title, x, y, w, h, layer, isOnScreen }] }. Coordinates are

• ocr_image

  Extract text from a local image or PDF file using Apple Vision OCR (offline, no API key needed). USE WHEN: The user provides a local file path to an image, screenshot, scanned document, or PDF and wants to extract the text from it. DO NOT USE for: images hosted on URLs (download first), non-macOS systems, or when the user wants face/barcode detection (use the dedicated tools). Supported formats: j

• read_screen_text

  Capture the screen (or a window/app/region) and OCR it in one step — fully local, the screenshot never leaves this machine. Returns the visible text so you can check UI state without sending any image to the cloud. USE WHEN: "What does the screen/app show right now?", verifying a dialog appeared, reading an error message, checking state after an action. Parameters: same targeting as capture_screen

• ui_snapshot

  Return the layout of an app's window as structured JSON: every element's exact box, role, label and state from the macOS accessibility tree, optionally with colours and fonts — plus the visible text the tree does NOT account for. All computed on this Mac; the screenshot it takes never reaches the model. USE WHEN: You need to understand or reconstruct a layout rather than just find one element — "w

• vision_capabilities

  Report what this machine can do: macOS version, Screen Recording / Accessibility permission state, available displays (with point sizes and Retina scale), and capture engine status. USE WHEN: Before starting a UI-testing session, or when capture/OCR tools fail unexpectedly — this tells you whether the problem is a missing permission and what to tell the user. Returns: JSON { macosVersion, helperVe

• Code scan5 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancelast push 67 days ago12/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Safety score

88/100

higher than 75% of 48,255 servers

Tools

13

the typical server has 7

Tools that change things

8%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

8

more than 86% of 28,688 servers

Downloads a week

97

more than 62% of 12,191 servers with a package

Macos Vision: common questions

Is Macos Vision MCP server safe?

Yes, by our scan: it is graded A (88/100). Read the Macos Vision safety report

How do I install Macos Vision?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Macos Vision need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is Macos Vision maintained?

The last commit was 71 days ago (2026-08-25). The latest release is v0.7.0.

How does Macos Vision compare with other MCP servers?

safety score 88/100 (higher than 75% of 48,255 servers); tools 13 (the typical server has 7); tools that change things 8% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.