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?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-linux-desktop take a screenshot of the active window" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-linux-desktop

by wizardofweb125-lab

Overview Schema Related Servers Score Discussions

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: Linux MCP Server

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 installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

desk-mcp
OS Automation App Automation Command Line
KpihX
A
license
-
quality
D
maintenance
A desktop automation MCP server that enables AI agents to interact with Linux environments through screenshots, window inspection, and input simulation. It provides tools for mouse control, keyboard input, and screen capture using xdotool and XDG Desktop Portals.
Last updated 2026-03-29
MIT
Linux MCP Server
OS Automation File Systems Shell Access
Ronnietag
A
license
B
quality
D
maintenance
Provides AI assistants with the ability to control Linux desktop environments through tools for file management, application launching, and system operations like clipboard access. It includes a multi-level security model to manage permissions for safe, elevated, and restricted actions.
Last updated 2026-03-25
6
MIT
linux-computer-use
OS Automation App Automation
tak-uukti
A
license
-
quality
C
maintenance
Enables AI agents to control Linux/X11 desktops by providing tools for taking screenshots, clicking, typing, and managing windows via AT-SPI and xdotool.
Last updated 2026-05-03
3
MIT
computer-use-linux
OS Automation Autonomous Agents
agent-sh
A
license
-
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.
Last updated 2026-08-01
490
345
MIT

View all related MCP servers

Related MCP Connectors

SentinelX
Operate your Linux servers from your LLM. Every action runs through an auditable allowlist.
Frenchie
OCR, transcription, file extraction, and image generation for AI agents via MCP.
autobrowserapproval-mcp
A paid remote MCP for AI agent browser approval MCP, built to return verdicts, receipts, usage logs,

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/wizardofweb125-lab/mcp-linux-desktop'

If you have feedback or need assistance with the MCP directory API, please join our Discord server