Observe & operate a Mac — files, processes, apps, shell, AppleScript, GUI — safe by default.
Connect Runs on your machine
claude mcp add mcp-macos -e MACOS_MODE=<MACOS_MODE> -e MACOS_ALLOW_EXEC=<MACOS_ALLOW_EXEC> -e MACOS_ALLOW_DELETE=<MACOS_ALLOW_DELETE> -e MACOS_ALLOW_INPUT=<MACOS_ALLOW_INPUT> -e MACOS_PATH_ALLOWLIST=<MACOS_PATH_ALLOWLIST> -- npx -y @dockndevai/[email protected]{
"mcpServers": {
"mcp-macos": {
"command": "npx",
"args": [
"-y",
"@dockndevai/[email protected]"
],
"env": {
"MACOS_MODE": "<MACOS_MODE>",
"MACOS_ALLOW_EXEC": "<MACOS_ALLOW_EXEC>",
"MACOS_ALLOW_DELETE": "<MACOS_ALLOW_DELETE>",
"MACOS_ALLOW_INPUT": "<MACOS_ALLOW_INPUT>",
"MACOS_PATH_ALLOWLIST": "<MACOS_PATH_ALLOWLIST>"
}
}
}
}{
"mcpServers": {
"mcp-macos": {
"command": "npx",
"args": [
"-y",
"@dockndevai/[email protected]"
],
"env": {
"MACOS_MODE": "<MACOS_MODE>",
"MACOS_ALLOW_EXEC": "<MACOS_ALLOW_EXEC>",
"MACOS_ALLOW_DELETE": "<MACOS_ALLOW_DELETE>",
"MACOS_ALLOW_INPUT": "<MACOS_ALLOW_INPUT>",
"MACOS_PATH_ALLOWLIST": "<MACOS_PATH_ALLOWLIST>"
}
}
}
}{
"servers": {
"mcp-macos": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dockndevai/[email protected]"
],
"env": {
"MACOS_MODE": "<MACOS_MODE>",
"MACOS_ALLOW_EXEC": "<MACOS_ALLOW_EXEC>",
"MACOS_ALLOW_DELETE": "<MACOS_ALLOW_DELETE>",
"MACOS_ALLOW_INPUT": "<MACOS_ALLOW_INPUT>",
"MACOS_PATH_ALLOWLIST": "<MACOS_PATH_ALLOWLIST>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
MACOS_MODEOptional | Access mode: read-only | read-write | admin. Starts read-only; writes need read-write. |
MACOS_ALLOW_EXECOptional | Set true to allow run_command / run_applescript / kill_process (admin mode). |
MACOS_ALLOW_DELETEOptional | Set true to allow delete_path (moves to Trash; admin mode). |
MACOS_ALLOW_INPUTOptional | Set true to allow GUI input (type/key/click; admin mode). Needs Accessibility permission. |
MACOS_PATH_ALLOWLISTOptional | Comma-separated path roots the agent may touch (empty = anywhere; protected paths still apply). |
Details
| Package | @dockndevai/[email protected] (NPM, stdio) |
| First published | 14 Oct 2026 |
| Last updated | 14 Oct 2026 |
| Registry name | io.github.dockndevai/mcp-macos |
More developer tools servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.