MCPHUB LogoMCPHUB
Back to directory
stefanoamorelli/hyprmcp

stefanoamorelli/hyprmcp

@stefanoamorelli

Community MCP server for Hyprland's hyprctl command-line interface, enabling natural language control of window management

hyprlandhyprctlwaylandwindow-managementlinuxautomationmcp

Installation & Configuration

{
  "mcpServers": {
    "Hyprland MCP Server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "subprocess",
        "mcp",
        "run",
        "<global_path_to_repo>/hyprmcp/hyprmcp/server.py"
      ],
      "env": {
        "PYTHONPATH": "<global_path_to_repo>/hyprmcp",
        "HYPRLAND_INSTANCE_SIGNATURE": "<your-hyprland-instance-signature>"
      }
    }
  }
}

Information

Transport
stdio
Language
Python
Created
2026/6/13
Updated
2026/6/13
Homepage
https://github.com/stefanoamorelli/hyprmcp