LocalFree

shotbox MCP server

mishan/shotbox

Runs real GUI programs in a sealed X11 or Wayland session where an agent can read the accessible tree, take screenshots and clips with sound, click, type and drive gamepads, then check what it finds: unnamed controls, contrast, Tab order, screen reader announcements and audio dropouts.

1 GitHub stars

Install shotbox in Claude Code

Claude Code
claude mcp add shotbox -- uvx shotbox
mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)
{
  "mcpServers": {
    "shotbox": {
      "command": "uvx",
      "args": [
        "shotbox"
      ]
    }
  }
}

Frequently asked questions

What does the shotbox MCP server do?

Runs real GUI programs in a sealed X11 or Wayland session where an agent can read the accessible tree, take screenshots and clips with sound, click, type and drive gamepads, then check what it finds: unnamed controls, contrast, Tab order, screen reader announcements and audio dropouts.

Is the shotbox MCP server free?

Yes, most likely. Open source and no paid account or API key is mentioned in the listing. Check the provider for current pricing.

Does shotbox run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add shotbox to Claude Code?

Run: claude mcp add shotbox -- uvx shotbox

More other tools & integrations MCP servers

View all