# computer-use-linux MCP server

> Provides AI agents with structured control over Linux desktops using semantic accessibility trees, window targeting, and input synthesis.

- Repository: https://github.com/agent-sh/computer-use-linux
- Page: https://hostedmcp.org/servers/agent-sh/computer-use-linux
- Transport: stdio
- Stars: 871
- License: MIT

## Install

### Claude Code

```sh
claude mcp add computer-use-linux -- npx -y @agent-sh/computer-use-linux
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "computer-use-linux": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-sh/computer-use-linux"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "computer-use-linux": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agent-sh/computer-use-linux"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "computer-use-linux": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-sh/computer-use-linux"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.computer-use-linux]
command = "npx"
args = ["-y", "@agent-sh/computer-use-linux"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "computer-use-linux": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-sh/computer-use-linux"
      ]
    }
  }
}
```

## Tools (3)

- `screenshot_after`
- `screenshot_file_path`
- `include_tree`

## FAQ

### Does this work on Wayland?

Yes, it provides Wayland support using /dev/uinput or org.freedesktop.portal.RemoteDesktop for pointer actions and various methods for text entry.

### Which Linux desktop environments are supported?

It supports GNOME, KDE Plasma/KWin, Hyprland, niri, COSMIC, i3, Sway, labwc, and other wlroots compositors, as well as X11.

### How can I check if my system is ready for use?

You can run the 'computer-use-linux doctor' command to receive a structured JSON readiness report covering platform, portals, and accessibility.