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
claude mcp add bad-ass-mcp -- uvx bad-ass-mcpWhat 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-mcpuvx runs the command named after the package; if the README names another one, use uvx --from bad-ass-mcp <command>
Platform CLI
codex mcp add bad-ass-mcp -- uvx bad-ass-mcpuvx runs the command named after the package; if the README names another one, use uvx --from bad-ass-mcp <command>
Config file
{
"mcpServers": {
"bad-ass-mcp": {
"command": "uvx",
"args": [
"bad-ass-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from bad-ass-mcp <command>
Config file
{
"servers": {
"bad-ass-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"bad-ass-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from bad-ass-mcp <command>
Platform CLI
gemini mcp add bad-ass-mcp uvx bad-ass-mcpuvx 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.