Skip to main content
Glama
Lord93jdiso

hyprland-mcp

by Lord93jdiso
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Hyprland MCP Server

MCP (Model Context Protocol) server for controlling Hyprland via AI agents.

Talk to Hyprland over hyprctl — query state, dispatch commands, change settings, edit config.

Requires running inside a Hyprland session.

Tools

Query:

Tool

What it does

hyprctl_raw

Run any hyprctl command

get_monitors

List monitors

get_workspaces

List workspaces

get_clients

List windows

get_active_window

Focused window details

get_devices

Input devices

get_binds

Keybinds

get_option

Any config option value

get_version

Hyprland version

get_layers

Compositor layers

Actions:

Tool

What it does

dispatch

Run a dispatcher (workspace, exec, kill, floating...)

set_keyword

Change a setting on the fly

reload_config

Reload hyprland.conf

notify

Send notification

kill_window

Kill-window mode

Config:

Tool

What it does

read_config

Read hyprland.conf

get_config_section

Parse a specific section

set_config_value

Edit a value + reload

add_config_line

Append a line + reload

Related MCP server: hyprland-mcp-server

Install

pip install mcp
python mcp_server.py

opencode.jsonc

{
  "hyprland-mcp": {
    "type": "local",
    "command": ["python", "-m", "mcp_server"],
    "env": { "PYTHONPATH": "/path/to/hyprland-mcp" },
    "enabled": true
  }
}

Wiki

https://wiki.hypr.land/ — embedded as knowledge://hyprland-wiki resource.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Wayland MCP Server

    kurojs
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to automate Wayland desktop environments through screenshot analysis, mouse control, and keyboard input simulation. It supports visual context via VLM providers like Gemini and OpenRouter to perform complex, multi-step desktop actions.
    28 PyPI
    10
    GPL 3.0

  • hyprland-mcp

    Keylessboi
    F
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to control a Hyprland Wayland desktop by listing windows, capturing screenshots, and sending input to a dedicated agent workspace without disrupting the user's screen.
    -

  • astra-linux-agent

    novique-ai
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables an AI agent to see and control a Linux desktop via Wayland/Hyprland, providing screenshots, structured desktop state, pointer/keyboard input, semantic window/workspace tools, and a policy engine for safe execution.
    Apache 2.0