Skip to content
Agentmart
Submit a tool

MCP Mac Control

Full macOS control — drive a Mac like a human: shell, AppleScript, files, and human-like GUI.

Connector by dockndevai · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)
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/dockndevai-mcp-mac-control

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

Full macOS control — drive a Mac like a human: shell, AppleScript, files, and human-like GUI.

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 and install config. Checked Oct 25, 2026.

Tools
11 read · 10 write · 3 delete · 2 not yet classified
Secrets
None asked for
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 26

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

Read 11 · Look things up without changing anything.

  • get_clipboard
  • get_frontmost_app
  • get_screen_size
  • list_apps
  • list_directory
  • list_processes
  • list_windows
  • quit_app
  • read_file
  • screenshot
  • system_info

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

  • click
  • drag
  • key_press
  • move_mouse
  • notify
  • run_applescript
  • scroll
  • set_clipboard
  • type_text
  • write_file

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

  • delete_path
  • kill_process
  • run_command

Not yet classified 2 · We could not tell from the name and description.

  • activate_app
  • open

Secrets and settings it asks for

Other settings (environment variables or headers).

  • MACCTL_CONFIRM
  • MACCTL_MODE
  • MACCTL_PATH_ALLOWLIST
  • MACCTL_PROTECTED_PATHS
  • MACCTL_SAFE_MODE

Files it touches

  • Any path the agent passes to its tools

Tools (26)

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

  • activate_appActivate (focus) an app

    Bring an application to the front (launching it if needed) so subsequent clicks/keystrokes go to it. Give the app's name, e.g. 'Safari', 'Notes'.

  • clickClick

    Click at screen coordinates. Requires admin mode AND MACCTL_ALLOW_INPUT=true, and the `cliclick` tool (brew install cliclick).

  • delete_pathDelete a path (to Trash)

    Move a file or folder to the Trash (recoverable). Requires admin mode AND MACCTL_ALLOW_DELETE=true. Honours the path allowlist and refuses protected paths.

  • dragDrag

    Press at (x1,y1), move to (x2,y2), and release — a human-style drag (select text, move a window, drag a file). Requires admin mode AND MACCTL_ALLOW_INPUT=true, and the `cliclick` tool.

  • get_clipboardRead the clipboard

    Return the current text contents of the macOS clipboard.

  • get_frontmost_appFrontmost app

    Return the name of the frontmost (active) application.

  • get_screen_sizeScreen size

    Return the overall desktop size AND every display's global point bounds (origin x/y, width, height, scale, main) — use it to reason about click coordinates across monitors.

  • key_pressPress a key

    Press a key (e.g. return, tab, escape, arrows, or a character) with optional modifiers (command/option/control/shift). Requires admin mode AND MACCTL_ALLOW_INPUT=true.

  • kill_processKill a process

    Send a signal (default SIGTERM) to a process by pid. Requires admin mode AND MACCTL_ALLOW_EXEC=true.

  • list_appsList running apps

    List the names of currently running (non-background) applications.

  • list_directoryList a directory

    List the entries (name, type, size) of a directory. Honours the path allowlist.

  • list_processesList processes

    List running processes (pid, cpu%, mem%, command), busiest first.

  • list_windowsList windows

    List the windows of the frontmost app with each window's name, position and size — so you can click or drag reliably. Needs Accessibility permission for the host process.

  • move_mouseMove the mouse

    Move the cursor to screen coordinates. Requires admin mode AND MACCTL_ALLOW_INPUT=true (cliclick).

  • notifyShow a notification

    Post a macOS notification with a title and message.

Show 11 more tools
  • openOpen a file, URL or app

    Open a file/folder path or URL with its default handler, or launch an app by name (set app=true).

  • quit_appQuit an app

    Ask an application to quit (graceful). Unsaved changes may prompt inside the app. Give the app's name.

  • read_fileRead a file

    Read a text file's contents (capped at MACCTL_MAX_FILE_BYTES). Honours the path allowlist.

  • run_applescriptRun AppleScript / JXA

    Run an AppleScript (or JavaScript for Automation) snippet via osascript. Powerful — can drive any scriptable app. Requires admin mode AND MACCTL_ALLOW_EXEC=true.

  • run_commandRun a command

    Run a program with arguments (no shell — pass argv, not a command line). Requires admin mode AND MACCTL_ALLOW_EXEC=true; the program must be in MACCTL_COMMAND_ALLOWLIST when that is set. For a shell pipeline, run command="zsh", args=["-c","…"].

  • screenshotScreenshot

    Capture a display as a PNG and return it. The image is downscaled to POINTS, so it is 1:1 with click coordinates. Omit `display` to capture the display holding the frontmost window (handy with a second monitor); pass 0 for the main display. Needs Screen Recording permission.

  • scrollScroll

    Scroll the mouse wheel in a direction by a number of lines (over whatever is under the cursor / frontmost). Requires admin mode AND MACCTL_ALLOW_INPUT=true.

  • set_clipboardSet the clipboard

    Replace the macOS clipboard contents with the given text.

  • system_infoSystem info

    Report macOS version, hardware, memory, load, uptime and the current user.

  • type_textType text

    Type literal text into the frontmost app (keystrokes). Requires admin mode AND MACCTL_ALLOW_INPUT=true, plus Accessibility permission for the host process.

  • write_fileWrite a file

    Create or overwrite a text file. Honours the path allowlist, refuses protected paths, and asks for confirmation before overwriting an existing file.

Signals

Stars
0
Forks
0
Open issues
0
Weekly downloads
10
Last commit
Oct 19, 2026 (10 days ago)
Last release
Sep 26, 2026 (1 month ago)
Last package publish
Sep 26, 2026 (1 month ago)

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

Details

Registry name
io.github.dockndevai/mcp-mac-control
Version
0.3.1
Auth
No auth
Packages
npm @dockndevai/mcp-mac-control
License
MIT
Repository
github.com/dockndevai/mcp-mac-control
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql

More from dockndevai

Cite this page

MCP Mac Control. Agent Mart. https://agentmart.dev/connectors/dockndevai-mcp-mac-control (last updated 2026-10-25)