Skip to main content
Glama
Lord93jdiso

hyprland-mcp

by Lord93jdiso
OverviewSchemaRelated ServersScoreDiscussions
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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • Wayland MCP Server

    kurojs
    A
    license
    Not graded
    quality
    C
    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.
    7
    GPL 3.0

  • arch-niri-mcp

    oki3505F
    A
    license
    A
    quality
    B
    maintenance
    Enables AI assistants to inspect, control, and automate Arch Linux/CachyOS and the Niri Desktop Environment through natural language, featuring tools for window management, system administration, package queries, and hardware control.
    35
    MIT

  • 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.
    -

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lord93jdiso/hyprland-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server