Skip to main content
MCP server CX Codex

bad-ass-mcp — Claude Code MCP server: features and setup

The bad-ass-mcp MCP server for Claude Code controls desktop interfaces through the operating system’s accessibility tree. It finds controls, enters text, and performs actions in apps.

MIT ★ 8 updated 2026-11-15

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add bad-ass-mcp -- uvx bad-ass-mcp
Open on GitHub

What bad-ass-mcp does

bad-ass-mcp reads accessibility data from application windows and interacts with controls directly, rather than relying on screenshot analysis. It can list windows, locate controls by role or name, click them, enter text, and choose list items. It also waits for windows or elements, runs action sequences, and records the screen.

The server uses platform accessibility APIs on Windows, macOS, and Linux. Custom-drawn panels and canvas views may have no readable tree; those cases need screenshot and click_at. The install command runs the server through uvx.

What it helps with

  • locate a button or field in an app window
  • enter text and choose an item from a list
  • record the screen or run a sequence of actions

Example prompts for the agent

  • Find the editor window and click the Export button.
  • Enter the project name in the search field, then select the matching list item.

How to install bad-ass-mcp

Platform CLI

claude mcp add bad-ass-mcp -- uvx bad-ass-mcp

uvx runs the command named after the package; if the README names another one, use uvx --from bad-ass-mcp <command>

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about bad-ass-mcp

How do I install bad-ass-mcp in Claude Code?

Run claude mcp add bad-ass-mcp -- uvx bad-ass-mcp.

What does bad-ass-mcp do?

It controls desktop apps through the operating system’s accessibility tree. The server can locate and operate controls, enter text, and run action sequences.

What does bad-ass-mcp need to run?

The install command requires uvx. The server uses the accessibility APIs provided by Windows, macOS, or Linux.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open