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)

Chalk Labs

Need help deploying MCP Mac Control?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

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.

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 (13 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 Registry github-graphql

More from dockndevai

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped: 50+; launches shipped
media placements: 500+; media placements
founders on every account: 2; founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get MCP Mac Control running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Need help deploying MCP Mac Control?

Call Get help

Cite this page

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