How do I install the macbeth mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

Macbeth MCP Server

Open-source Computer Use for macOS. See and operate Mac applications through MCP or TypeScript, including native and Electron interfaces.

Local serverstdioTypeScript

What is the Macbeth MCP Server?

Open-source Computer Use for macOS. See and operate Mac applications through MCP or TypeScript, including native and Electron interfaces.

The short version

Use your own agent. — Macbeth is a control layer, not a model or agent runtime
Structured when possible. — Query roles, labels, values, enabled state, hierarchy, and stable handles instead of relying only on coordinates
Visual when necessary. — Fall back to window capture and OCR when accessibility metadata is thin
Application-aware. — Versioned skills preserve workflows, shortcuts, and known failure modes
Scriptable. — Use the same primitives interactively over MCP or directly from TypeScript

What it needs from you

macOS 14 (Sonoma) or later - Node.js 20+ - Swift 6.0+ only when building the daemon from source

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Macbeth MCP Server

{
  "mcpServers": {
    "macbeth": {
      "command": "npx",
      "args": ["-y", "macbeth"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

macOS 14 (Sonoma) or later - Node.js 20+ - Swift 6.0+ only when building the daemon from source

Frequently asked questions

Open-source Computer Use for macOS. See and operate Mac applications through MCP or TypeScript, including native and Electron interfaces. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.