# bad-ass-mcp

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8 repo stars
- Author: HoldMyBeer-gg
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HoldMyBeer-gg/bad-ass-mcp
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/bad-ass-mcp

## What it 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`.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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>

### Codex

**Platform CLI**
```bash
codex 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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini 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>

## When to use it
- 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
- Find the editor window and click the Export button.
- Enter the project name in the search field, then select the matching list item.

## Similar
- [agent-desktop](https://affpapa.org/en/nevibecode/skills/agent-desktop.md) — skill · 12100 installs
- [Computer Use](https://affpapa.org/en/nevibecode/mcp/computer-use.md) — MCP server · ★ 406 repo stars
- [computer-control](https://affpapa.org/en/nevibecode/skills/computer-control.md) — skill · ★ 219 repo stars
- [macOS-MCP](https://affpapa.org/en/nevibecode/mcp/macos-mcp.md) — MCP server · ★ 248 repo stars
- [Munim Computer Use](https://affpapa.org/en/nevibecode/mcp/munim-computer-use.md) — MCP server · ★ 43 repo stars
- [Ghost](https://affpapa.org/en/nevibecode/mcp/ghost.md) — MCP server · ★ 28 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
