macOS-MCP server

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

• App

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

• Click

  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.

• Move

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

• Notificationwrite action

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

• Scrape

  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.

• Shellwrite action

  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, s

• Shortcutwrite action

  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.

• Snapshot

  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.

• Type

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

• Wait

  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.

• Code scan33 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 19 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Safety score

94/100

higher than 96% of 48,255 servers

Tools

11

the typical server has 7

Tools that change things

27%

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

GitHub stars

186

more than 95% of 28,688 servers

macOS-MCP: common questions

Is macOS-MCP server safe?

Yes, by our scan: it is graded A (94/100). Read the macOS-MCP safety report

How do I install macOS-MCP?

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

Does macOS-MCP need an API key?

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

Is macOS-MCP maintained?

The last commit was 56 days ago (2026-09-09). The latest release is v0.3.6.

How does macOS-MCP compare with other MCP servers?

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