Macos MCP Server

What the code does

We read the source, 3 d ago · rules 995398eba69f

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

    const result = await execFile(SYSTEM_BINARIES.ps, ['-o', 'comm=', '-p', String(process.ppid)], {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add macos-mcp-server -- npx -y @cyanheads/macos-mcp-server

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

[mcp_servers.macos-mcp-server]
command = "npx"
args = ["-y", "@cyanheads/macos-mcp-server"]

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

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

Optional settings from the registry entry, left out of the block above: MCP_TRANSPORT_TYPE (Selects the HTTP transport), MACOS_SCREENSHOT_DIR (Default directory for screenshot files. Defaults to ~/Desktop when empty), MACOS_DISPLAY_LAYOUTS (JSON object mapping layout names to displayplacer argument strings for apply_layout), MCP_HTTP_HOST (The hostname for the HTTP server), MCP_HTTP_PORT (The port to run the HTTP server on), MCP_HTTP_ENDPOINT_PATH (The endpoint path for the MCP server), MCP_AUTH_MODE (Authentication mode: none, jwt, or oauth), MCP_LOG_LEVEL (Minimum log level for output: debug, info, notice, warning, error).