launch_app
Launch applications on Hyprland desktop environments by executing commands to open programs or files directly from the system.
Instructions
Launch an application (detached, via Hyprland).
Args: command: The command to run (e.g. "firefox", "kitty", "nautilus ~/Documents")
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"command": "<command>"
},
"name": "launch_app"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| command | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
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}"