LogoSTMCP
Download
hyprmcp

Hyprland MCP Server

A lightweight MCP server that exposes Hyprland's hyprctl functionality to language models, enabling natural language control of window management, layouts, and inputs for the Hyprland Wayland compositor.

Tools

1. run_hyprctl_command

Executes arbitrary hyprctl commands.

2. get_version

Retrieves the Hyprland version and build info.

3. list_monitors

Lists all connected monitors and properties.

4. list_workspaces

Lists all active workspaces.

5. list_clients

Lists all windows and their properties.

6. list_devices

Lists all connected input devices.

7. get_active_window

Shows the currently active window details.

8. list_layers

Displays all layers in the compositor.

9. get_splash

Retrieves the current random splash message.

10. dispatch_command

Dispatches a command to Hyprland.

11. set_keyword

Dynamically sets a configuration keyword.

12. reload_config

Forces a reload of the Hyprland config file.

13. enter_kill_mode

Enables kill mode to terminate windows by click.

Open Graph image for Hyprland MCP Server

JSON Config

{
  "Hyperland MCP Server": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "mcp[cli]",
      "--with",
      "subprocess",
      "mcp",
      "run",
      "<global path of the repo>/hyprmcp/hyprmcp/server.py"
    ],
    "env": {
      "PYTHONPATH": "<global path of the repo>/hyprmcp",
      "HYPRLAND_INSTANCE_SIGNATURE": "<your-hyprland-instance-signature>"
    }
  }
}

Useful Links

Information