hyprland-mcp

Instructions

Implementation Reference

• hyprland_mcp/server.py:229-237 (handler)

  The launch_app tool handler implementation in server.py, which uses hyprctl.dispatch to execute the command.

  @mcp.tool()
  async def launch_app(command: str) -> str:
      """Launch an application (detached, via Hyprland).
  
      Args:
          command: The command to run (e.g. "firefox", "kitty", "nautilus ~/Documents")
      """
      await hyprctl.dispatch("exec", command)
      return f"Launched: {command}"