Skip to content
MCP server

MCP Macos

Observe & operate a Mac — files, processes, apps, shell, AppleScript, GUI — safe by…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.1
Listing updated
5 days ago

About MCP Macos

MCP Macos is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Observe & operate a Mac — files, processes, apps, shell, AppleScript, GUI — safe by default.

Install

Run in a terminal

claude mcp add mcp-macos -- npx -y @dockndevai/mcp-macos

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-macos": {
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-macos"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-macos": {
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-macos"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-macos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-macos"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-macos": {
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-macos"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-macos": {
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-macos"
      ]
    }
  }
}

Configuration

  • MACOS_MODEAccess mode: read-only | read-write | admin. Starts read-only; writes need read-write.
  • MACOS_ALLOW_EXECSet true to allow run_command / run_applescript / kill_process (admin mode).
  • MACOS_ALLOW_DELETESet true to allow delete_path (moves to Trash; admin mode).
  • MACOS_ALLOW_INPUTSet true to allow GUI input (type/key/click; admin mode). Needs Accessibility permission.
  • MACOS_PATH_ALLOWLISTComma-separated path roots the agent may touch (empty = anywhere; protected paths still apply).

Pricing

Open source

MCP Macos FAQ

Is MCP Macos free?

Yes. MCP Macos is open source, so you can use and self-host it for free.

How do I add MCP Macos to Claude Code?

Run this command in your terminal: claude mcp add mcp-macos -- npx -y @dockndevai/mcp-macos