AI Atlas

Developer Tools · OS Automation

hyprmcp logo

hyprmcp

stefanoamorelli/hyprmcp

A lightweight, unofficial Model Context Protocol (MCP) server that exposes all the functionality of hyprctl—the command-line interface for the Hyprland Wayland compositor—to language models.

View on GitHub

Install

Client configuration

{
  "mcpServers": {
    "server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "subprocess",
        "mcp",
        "run",
        "<global path of the repo>/hyprmcp/hyprmcp/server.py"
      ],
      "env": {
        "PYTHONPATH": "<PYTHONPATH>",
        "HYPRLAND_INSTANCE_SIGNATURE": "<HYPRLAND_INSTANCE_SIGNATURE>"
      }
    }
  }
}

Environment variables

HYPRLAND_INSTANCE_SIGNATURE
Author
@stefanoamorelli
Category
Developer Tools, OS Automation
License
MIT
Updated
Oct 6, 2026

About hyprmcp

This server enables natural language interfaces to query and control Hyprland's window management, layouts, inputs, and more.

Tools (13)

  • run_hyprctl_command

    Executes arbitrary hyprctl commands.

  • get_version

    Retrieves the Hyprland version and build info.

  • list_monitors

    Lists all connected monitors and properties.

  • list_workspaces

    Lists all active workspaces.

  • list_clients

    Lists all windows and their properties.

  • list_devices

    Lists all connected input devices.

  • get_active_window

    Shows the currently active window details.

  • list_layers

    Displays all layers in the compositor.

  • get_splash

    Retrieves the current random splash message.

  • dispatch_command

    Dispatches a command to Hyprland.

  • set_keyword

    Dynamically sets a configuration keyword.

  • reload_config

    Forces a reload of the Hyprland config file.

  • enter_kill_mode

    Enables kill mode to terminate windows by click.

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS

Related MCP servers

More servers
Playwright logo

Playwright

microsoft/playwright

72.2k

Playwright is a framework for web automation and testing. It drives Chromium, Firefox, and WebKit with a single API — in your tests, in your scripts, and as a tool for AI agents.

Developer Tools
repomix logo

repomix

yamadashy/repomix

15.2k

Repomix is a tool that packs a codebase into an AI-friendly format, supporting local and remote repository processing and providing code compression, security checks and multiple output formats.

Developer Tools
UI-TARS-desktop logo

UI-TARS-desktop

bytedance/UI-TARS-desktop

12.9k

TARS is ByteDance's multimodal AI agent stack, shipping two projects: Agent TARS (a CLI and Web UI agent built on MCP) and UI-TARS-desktop (a desktop GUI agent).

Developer Tools
blender logo

blender

ahujasid/blender-mcp

10.6k

formerly blender-mcp — the PyPI package is now mcp-for-blender. Existing setups keep working; no config change is required. Read more.

Developer Tools
Playwright Browser Automation logo

Playwright Browser Automation

microsoft/playwright-mcp

9.2k

A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. This server enables LLMs to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models.

Developer Tools
2344 logo

2344

comet-ml/opik

7k

Opik is the open-source LLM observability and evaluation platform for AI agent tracing, LLM evaluation, prompt management, and production monitoring. Built by Comet. Apache-2.0 licensed, free to self-host the full platform, with 20,000+ GitHub stars.

Developer Tools