GNOME UI MCP

stdio

GNOME Wayland desktop automation via AT-SPI discovery and Mutter input.

Getting Started

npx @getmcp/cli add io.github.asattelmaier/gnome-ui-mcp

Requires Docker Engine. Community-contributed server. Review source before installing.

Claude Desktop guide →Vscode guide →Cursor guide →Windsurf guide →

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.asattelmaier/gnome-ui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "apparmor=unconfined",
        "host",
        "{uid}:{gid}",
        "DBUS_SESSION_BUS_ADDRESS",
        "XDG_RUNTIME_DIR",
        "WAYLAND_DISPLAY",
        "DISPLAY",
        "XDG_SESSION_TYPE",
        "{xdg_runtime_dir}:{xdg_runtime_dir}",
        "/tmp/.X11-unix:/tmp/.X11-unix:ro",
        "run",
        "-i",
        "--rm",
        "ghcr.io/asattelmaier/gnome-ui-mcp:0.1.3"
      ]
    }
  }
}

Claude Desktop MCP documentation