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: kwin-mcp

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 installed

A
license - permissive license
-
quality - not tested
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Servers

  • Wayland MCP Server

    kurojs
    A
    license
    -
    quality
    B
    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.
    6
    GPL 3.0

  • kwin-mcp

    isac322
    A
    license
    -
    quality
    C
    maintenance
    Enables AI agents to automate Linux desktop GUI by launching and interacting with Wayland applications in isolated virtual KWin sessions, or connecting to live desktops for collaborative automation.
    39
    MIT

  • jenny-mcp-server

    RhaDar12
    F
    license
    -
    quality
    B
    maintenance
    Enables AI agents to interact with the Windows desktop environment, including browser control, clipboard, file management, GitHub, Roblox Studio, OCR, and more, with a privileged approval system for risky actions.

View all related MCP servers

Related MCP Connectors

  • agentbay-mcp

    Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.

  • Hexis

    Git-backed platform for skills, tools, and context for AI agents

  • Hint-Services-obsidian-github-mcp

    Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…

View all MCP Connectors

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