Hyprland MCP Server is a lightweight, unofficial MCP server that exposes the full functionality of hyprctl—the Hyprland Wayland compositor's command-line interface—to language models. It enables natural language interfaces to query and control Hyprland's window management, layouts, inputs, and related features. The project is experimental and in beta, designed to run on Linux with Python 3.10+ and to integrate with MCP clients. A typical workflow involves cloning the repository, obtaining the HYPRLAND_INSTANCE_SIGNATURE, and configuring an MCP client (for example Claude Desktop) to invoke the server script with the correct environment variables (PYTHONPATH and HYPRLAND_INSTANCE_SIGNATURE). The server exposes a curated set of tools that map directly to hyprctl operations, enabling model-driven commands such as listing monitors, workspaces, windows, and devices, querying the active window, dispatching commands, and more. This enables natural language prompts like “switch to workspace 2” or “what is the current active window,” which are translated to hyprctl commands by the MCP server. The README also references Hyprland and MCP SDK documentation for guidance.