Skip to content
Agentmart
Submit a tool

macOS-MCP

MCP server for macOS desktop automation via the Accessibility API.

Connector by Jeomon · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 223
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/jeomon-macos-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

MCP server for macOS desktop automation via the Accessibility API.

Use cases: workflow-automation

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
5 read · 9 write · 5 delete
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 19

Read from the source code; the running server may list different tools.

Read 5 · Look things up without changing anything.

  • mac_snapshot
  • mac_wait
  • Scrape
  • Snapshot
  • Wait

Write 9 · Create, change, send or run things.

  • Desktop
  • mac_app
  • mac_click
  • mac_scroll
  • mac_shortcut
  • mac_type
  • Move
  • Notification
  • Scroll

Delete 5 · Delete, drop, revoke or wipe things.

  • App
  • Click
  • Shell
  • Shortcut
  • Type

Network hosts it talks to 5

  • apple.com · found in code
  • astral.sh · found in code
  • docs.astral.sh · found in code
  • github.com · found in code
  • us.i.posthog.com · found in code

Files it touches

  • /usr/sbin/screencapture
  • Your home directory (~)
  • ~/.macos-mcp

Tools (19)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • Appcan change or delete data

    Manages macOS applications with four modes: 'launch' (opens the application), 'resize' (adjusts active window size), 'move' (repositions active window), 'switch' (brings specific app into focus).

  • Clickcan change or delete data

    Performs mouse clicks at specified coordinates [x, y]. Supports button types: 'left' for selection/activation, 'right' for context menus, 'middle'. Supports clicks: 0=hover only, 1=single click, 2=double click.

  • Desktop

    Manages Mission Control desktop Spaces. mode='create' opens Mission Control and clicks 'Add Desktop' to create a new virtual desktop, verifying the space count increased before reporting success. Uses Accessibility only. Requires Accessibility permission. UI layout can vary by macOS version/locale.

  • mac_app

    Launch, switch, move, or resize macOS applications/windows through macOS-MCP.

  • mac_click

    Click macOS screen coordinates through macOS-MCP. Get coordinates from mac_snapshot first.

  • mac_scroll

    Scroll vertically or horizontally through macOS-MCP. Coordinates are optional but recommended from mac_snapshot.

  • mac_shortcut

    Run a macOS keyboard shortcut through macOS-MCP, e.g. command+c, command+l, command+space.

  • mac_snapshot

    Read macOS UI state through macOS-MCP Snapshot. Returns interactive elements and coordinates; set use_vision=true only when an annotated screenshot is needed.

  • mac_type

    Type text at macOS screen coordinates through macOS-MCP. Get coordinates from mac_snapshot first.

  • mac_wait

    Wait for UI loading/animations through macOS-MCP.

  • Move

    Moves mouse cursor to coordinates [x, y]. Set drag=True to perform a drag-and-drop operation from current position to target coordinates.

  • Notification

    Sends a macOS notification banner with a message, title, optional subtitle, and optional sound.

  • Scraperead-only

    Fetch content from a URL. Performs a lightweight HTTP request and returns the page content as text.

  • Scroll

    Scrolls at coordinates [x, y] or current mouse position if loc=None. Type: vertical (default) or horizontal. Direction: up/down for vertical, left/right for horizontal. wheel_times controls scroll amount.

  • Shellcan change or delete data

    Execute commands on macOS. Modes: 'shell' (default) for bash/zsh commands, 'osascript' for AppleScript. Use for file system, process management, system operations, and automation scripts. SECURITY WARNING: Commands are executed with the same permissions as the terminal/application running this server. Review and understand all actions before execution, especially those involving file operations, system modifications, or external processes.

Show 4 more tools
  • Shortcutcan change or delete data

    Executes keyboard shortcuts using key combinations separated by +. Examples: "command+c" (copy), "command+v" (paste), "command+tab" (switch apps), "command+space" (Spotlight). Note: Use "command" instead of "ctrl" on macOS.

  • Snapshotread-only

    Captures complete desktop state including: focused window, open applications, interactive elements (buttons, text fields, links, menus with coordinates), and scrollable areas. Set use_vision=True to include screenshot with numbered annotations on interactive elements. Always call this first to understand the current desktop state before taking actions.

  • Typecan change or delete data

    Types text at specified coordinates [x, y]. Set clear=True to clear existing text first. Set press_enter=True to submit after typing. Set caret_position to 'start', 'end', or 'idle' (default).

  • Waitread-only

    Pauses execution for specified duration in seconds. Use when waiting for: applications to launch, UI animations to complete, content to load. Helps ensure UI is ready before next interaction.

Signals

Stars
223
Forks
34
Open issues
1
Contributors
11
Weekly downloads
374
Last commit
Oct 12, 2026 (17 days ago)
Last release
Sep 8, 2026 (1 month ago)
Last package publish
Sep 8, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.Jeomon/macos-mcp
Version
0.3.6
Auth
No auth
Packages
pypi macos-mcp
License
MIT
Repository
github.com/Jeomon/macos-mcp
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

macOS-MCP. Agent Mart. https://agentmart.dev/connectors/jeomon-macos-mcp (last updated 2026-10-24)