Gnome Desktop MCP Server

Desktop automation for GNOME Wayland via MCP. Take screenshots, manage windows, and inject keyboard/mouse input from AI assistants like Claude Code.

Local serverstdioPython

What is the Gnome Desktop MCP Server?

Desktop automation for GNOME Wayland via MCP. Take screenshots, manage windows, and inject keyboard/mouse input from AI assistants like Claude Code.

Configuration

  • GNOME Shell 45-49 (Wayland) - Python 3.12+

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
screenshotFull screen capture
screenshot_windowCapture a specific window
screenshot_areaCapture a rectangular region
pick_colorGet pixel color at coordinates
cleanup_screenshotsRemove temp screenshot files
list_windowsList all open windows
get_windowGet detailed window properties
focus_windowFocus and raise a window
move_resize_windowMove and resize a window
close_windowClose a window
list_workspacesList all workspaces
activate_workspaceSwitch workspace
key_pressPress a single key ("Return", "F5", "a")
key_comboKey combination ("Ctrl+Alt+t")
type_textType text character by character
mouse_moveMove mouse to coordinates
mouse_clickClick at coordinates
mouse_double_clickDouble-click
mouse_dragDrag from point A to point B
mouse_scrollScroll at coordinates
pingCheck extension is alive
get_monitorsList monitors with geometry

How to install the Gnome Desktop MCP Server

{
  "mcpServers": {
    "desktop-automation": {
      "command": "gnome-desktop-mcp"
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • GNOME Shell 45-49 (Wayland) - Python 3.12+

Example prompts to try

  • “Use Gnome Desktop MCP to Screenshots.”
  • “Use Gnome Desktop MCP to Windows.”
  • “Use Gnome Desktop MCP to Input.”

Frequently asked questions

Desktop automation for GNOME Wayland via MCP. Take screenshots, manage windows, and inject keyboard/mouse input from AI assistants like Claude Code. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.