Which integrations are available for this server?

Allows calling DBus methods on GNOME Shell and other GNOME services for desktop integration. Provides tools for controlling the Linux desktop environment, including window management, mouse and keyboard input, clipboard, audio, screenshots, OCR, accessibility, and system management.

How do I use mcp-linux-desktop?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

mcp-linux-desktop

by wizardofweb125-lab

Overview Schema Source Related Servers Discussions Admin

JavaScript

Local

MCP server for full Linux desktop control — windows, mouse, keyboard, clipboard, audio, screenshots, OCR, notifications, accessibility tree, and system management. Works with any MCP-compatible AI agent.

Setup

cd mcp-linux-desktop
npm install

Add to your MCP config:

{
  "mcpServers": {
    "linux-desktop": {
      "command": "node",
      "args": ["/path/to/mcp-linux-desktop/server.js"]
    }
  }
}

Related MCP server: desktop-mcp

Tools

Window Management

Tool	Description
`window_list`	List all open windows with IDs, names, geometry
`window_focus`	Focus a window by ID or name
`window_close`	Close a window
`window_minimize`	Minimize a window
`window_resize`	Resize and/or move a window

Mouse & Keyboard

Tool	Description
`mouse_move`	Move cursor to coordinates
`mouse_click`	Click (left/right/middle, single/double)
`mouse_scroll`	Scroll in any direction
`mouse_drag`	Drag from one position to another
`mouse_location`	Get current cursor position
`keyboard_type`	Type text
`keyboard_key`	Press key combo (e.g. `ctrl+a`, `alt+Tab`)

Apps & Files

Tool	Description
`app_launch`	Launch an application by name or command
`app_list`	List running graphical applications
`file_open`	Open a file or URL with its default app

Clipboard

Tool	Description
`clipboard_read`	Read clipboard contents
`clipboard_write`	Write text to clipboard

Audio

Tool	Description
`volume_get`	Get current volume and mute status
`volume_set`	Set volume (0-100) or toggle mute

Screen

Tool	Description
`screenshot`	Screenshot the screen or a region
`screen_observe`	Screenshot + screen metadata (resolution, active window, mouse position)
`ocr_screen`	Screenshot a region and extract text via OCR

Accessibility

Tool	Description
`ui_elements`	Read interactive UI elements (buttons, fields, menus) with screen coordinates via AT-SPI

System

Tool	Description
`system_info`	CPU, RAM, disk, uptime
`process_list`	List processes (optional name filter)
`process_kill`	Kill a process by PID or name
`notify`	Send a desktop notification
`brightness_get`	Get screen brightness
`dbus_call`	Call a DBus method (GNOME shell, systemd, etc.)

System dependencies

Required:

Node.js 18+
xdotool — window/mouse/keyboard control
xclip — clipboard (X11)
Python 3 + Pillow — screenshots

Optional:

wl-paste / wl-copy — clipboard on Wayland
tesseract-ocr + tesseract-ocr-fra — OCR
notify-send — desktop notifications
wpctl or pactl — audio control
gdbus — DBus calls
PyGObject + AT-SPI — accessibility tree (ui_elements)

Install on Ubuntu/Debian:

sudo apt install xdotool xclip python3-pil tesseract-ocr tesseract-ocr-fra \
  libnotify-bin pipewire-pulse gir1.2-atspi-2.0

Environment variables

Variable	Default	Description
`DISPLAY`	`:1`	X11 display to target

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Related MCP Connectors

box by Simular
ai.simular
A cloud Linux desktop for your AI: browse, click, type, read the screen and run commands.
Agent Orchestration Browser Automation Command Line
1
https://relay.simular.cloud/mcp
Mandala Computer
io.github.mandalacomputer
Cloud desktops for AI agents: create a Linux computer, see its screen, click, type and run tasks.
Agent Orchestration Virtualization OS Automation
1
https://app.mandala.computer/mcp
PC Remote Commander
io.github.pcremotecommander
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
File Systems Command Line Browser Automation
11
https://pc-remote-commander.pcremotecommander.workers.dev/mcp
Burrowbox
io.github.burrowbox
Persistent Linux computers for AI agents: desktop, signed-in browser, vault, apps and shell.
Agent Orchestration Autonomous Agents Virtualization
1
https://burrowbox.dev/mcp

Related MCP Servers

computer-use-linux
OS Automation Autonomous Agents
agent-sh
A
license
Not graded
quality
A
maintenance
Controls a real Linux desktop from any MCP host. Reads accessibility trees, takes screenshots, and drives clicks, scrolls, and keystrokes across GNOME, KDE/KWin, Hyprland, i3, and COSMIC.
Updated 3 days ago (2026-10-31 17:36 UTC)
3,456 npm
782
MIT
desktop-mcp
Agent Orchestration Testing & QA Tools
Zetakai
A
license
A
quality
C
maintenance
Enables LLMs to capture desktop screenshots and control the mouse and keyboard on Linux, including Wayland, through MCP.
Updated 2 months ago (2026-08-21 19:59 UTC)
11
MIT
rc-mcp
Shell Access File Systems OS Automation
champi-ai
A
license
Not graded
quality
A
maintenance
Enables controlling your own Linux desktop machines from any MCP-capable LLM client, with opt-in agent capabilities for shell, filesystem, processes, screenshots, system info, and input injection.
Updated 2 months ago (2026-08-31 07:24 UTC)
1
MIT
yale-agent
OS Automation Browser Automation File Systems
yaleedhaque
A
license
Not graded
quality
B
maintenance
Enables AI agents to automate a Linux desktop natively on Wayland, with 68 tools for screen capture, input simulation, browser automation, OCR, accessibility, media, audio, clipboard, notifications, filesystem, system, memory, and network operations through the MCP protocol.
Updated 2 months ago (2026-09-06 17:03 UTC)
MIT

Appeared in Searches

A server for finding information about Linux