Install Nib MCP

Prerequisites (read first)

1. A human must install Nib.app to /Applications before any agent config will work.
2. Restart your agent after you add or change MCP configuration.

Verify

After restart, ask the agent to call get_state. A healthy setup returns the active document path, selection, variables, and tree.

Claude Code (JSON)

{
  "mcpServers": {
    "nib": {
      "command": "/Applications/Nib.app/Contents/MacOS/Nib",
      "args": [
        "/Applications/Nib.app/Contents/Resources/mcp-shim/shim.js",
        "--agent",
        "claudeCodeCLI"
      ],
      "env": { "ELECTRON_RUN_AS_NODE": "1" },
      "type": "stdio"
    }
  }
}

Claude Desktop (JSON)

Same as Claude Code; set "claudeDesktop" as the --agent arg value.

Codex (TOML)

[mcp_servers.nib]
command = "/Applications/Nib.app/Contents/MacOS/Nib"
args = ["/Applications/Nib.app/Contents/Resources/mcp-shim/shim.js", "--agent", "codexCLI"]
startup_timeout_sec = 120
tool_timeout_sec = 300

[mcp_servers.nib.env]
ELECTRON_RUN_AS_NODE = "1"

Easiest path

Nib → Set up agents… — pick Claude Code, Codex, or Claude Desktop and click Apply. Nib backs up existing configs before merging the nib entry.

Full guide: Agent setup · Tools reference