Skip to main content
Glama
hypr-tools

hypr-tools

by 0aaryan

hypr-tools

The most comprehensive MCP server for Linux desktop automation -- 178 tools across 30 categories

Give your AI assistant full control over your Hyprland/Wayland desktop: audio, windows, themes, screenshots, Bluetooth, media, macros, RGB lighting, projectors, and more.

License: MIT MCP Node


Why hypr-tools?

  • 178 tools, 30 categories -- the largest Hyprland MCP server available

  • Zero config -- npx -y github:0aaryan/hypr-tools and you're running

  • No cloud dependencies -- everything runs locally via hyprctl, PipeWire, and standard Linux tools

  • Macro engine -- chain any tools into reusable multi-step automations

  • Works with every MCP client -- Claude Desktop, Claude Code, Cursor, Cline, Windsurf, and more

Related MCP server: arch-niri-mcp

What can it do?

Ask your AI to:

  • "Turn my volume down to 30%"

  • "Switch to the dark theme and change my wallpaper"

  • "Take a screenshot of my current window"

  • "Connect to my Bluetooth headphones"

  • "Move Firefox to workspace 3"

  • "Create a macro that dims lights and enables DND"

  • "Set my keyboard LEDs to red"

  • "Show my CPU and GPU stats"


Quick Start

Install

npm install -g github:0aaryan/hypr-tools

Or run directly:

npx -y github:0aaryan/hypr-tools

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "hypr-tools": {
      "command": "npx",
      "args": ["-y", "github:0aaryan/hypr-tools"]
    }
  }
}

Claude Code (CLI)

Add to your project or global settings (~/.claude/settings.json):

{
  "mcpServers": {
    "hypr-tools": {
      "command": "npx",
      "args": ["-y", "github:0aaryan/hypr-tools"]
    }
  }
}

Cursor / Windsurf

Add to your editor's MCP settings:

{
  "mcpServers": {
    "hypr-tools": {
      "command": "npx",
      "args": ["-y", "github:0aaryan/hypr-tools"]
    }
  }
}

Cline

Add to your Cline MCP config:

{
  "mcpServers": {
    "hypr-tools": {
      "command": "npx",
      "args": ["-y", "github:0aaryan/hypr-tools"]
    }
  }
}

From Source

git clone https://github.com/0aaryan/hypr-tools.git
cd hypr-tools
npm install
npm run build
node build/index.js

Requirements

  • Hyprland compositor (Wayland)

  • Linux (Arch, NixOS, Fedora, etc.)

  • Node.js >= 18

  • System utilities (most come pre-installed with Hyprland):

    • pactl (PulseAudio/PipeWire) -- audio

    • brightnessctl -- brightness

    • wl-clipboard -- clipboard

    • grim + slurp -- screenshots

    • wf-recorder -- screen recording

    • hyprctl -- Hyprland IPC

    • nmcli -- network

    • bluetoothctl -- Bluetooth

    • playerctl -- media

    • notify-send -- notifications


Configuration

Everything works out of the box. A few optional tools need hardware or extra setup:

Tools

What they need

led_*

A BLE LED strip (LEDDMX / ELK-BLEDOM family) and pip install bleak. Set HYPR_LED_ADDRESS to its MAC, or leave it unset and the strip is found by name.

projector_*

An Android projector with ADB over Wi-Fi, optionally Fully Kiosk Browser. Run projector_setup once; settings are saved in ~/.config/hypr-tools/projector.json.

wa_*

WhatsApp Web open in Firefox with a local bridge extension. Set FIREFOX_BRIDGE_URL if it isn't on http://localhost:7866.

theme, wallpaper, wallbash

HyDE. On other Hyprland setups these tools return an error.

voice scripts

src/tools/voice_* are optional push-to-talk and TTS helpers for Claude Code. They use a Python venv at ./voice-venv, or set HYPR_TOOLS_VENV.


Tool Categories (178 tools)

Tool

Description

get_volume

Get current audio output volume and mute state

set_volume

Set audio output volume (0-150%)

increase_volume

Increase volume by N percent

decrease_volume

Decrease volume by N percent

toggle_mute

Toggle audio output mute

get_mic_volume

Get microphone volume and mute state

set_mic_volume

Set microphone volume

toggle_mic_mute

Toggle microphone mute

list_audio_sinks

List all audio output devices

set_default_sink

Set default audio output device

list_audio_sources

List all audio input devices

set_default_source

Set default audio input device

Tool

Description

list_windows

List all open windows with details

get_focused_window

Get the currently focused window

focus_window

Focus a window by class or title

close_window

Gracefully close a window

kill_window

Force kill a window

toggle_float

Toggle floating mode

toggle_fullscreen

Toggle fullscreen mode

pin_window

Pin window on all workspaces

move_window_to_workspace

Move window to a workspace

resize_window

Resize a window

move_window

Move a window

toggle_split

Toggle split direction

group_window

Group/ungroup window

move_to_scratchpad

Move window to scratchpad

Tool

Description

projector_setup

Configure projector IP and credentials

projector_status

Get projector status

projector_open_url

Open a URL on the projector

projector_show_dashboard

Show dashboard on projector

projector_wake

Wake up the projector

projector_sleep

Put projector to sleep

projector_fullscreen

Toggle fullscreen on projector

projector_brightness

Set projector brightness

projector_reload

Reload current page

projector_screenshot

Take a screenshot on projector

projector_speak

Text-to-speech on projector

projector_scan

Scan for projectors on network

Tool

Description

get_current_theme

Get the active theme

set_theme

Set a theme by name

next_theme

Switch to next theme

prev_theme

Switch to previous theme

list_themes

List all available themes

get_wallbash_mode

Get wallbash color mode

set_wallbash_mode

Set wallbash color mode

get_rofi_style

Get current rofi style

set_rofi_style

Set rofi launcher style

Tool

Description

get_cpu_info

CPU usage and details

get_gpu_info

GPU information

get_memory_info

RAM usage

get_disk_info

Disk usage

get_battery_info

Battery status

get_uptime

System uptime

get_system_info

Full system overview

list_processes

List running processes

Tool

Description

get_wallpaper

Get current wallpaper path

set_wallpaper

Set wallpaper by path

next_wallpaper

Switch to next wallpaper

prev_wallpaper

Switch to previous wallpaper

list_wallpapers

List all wallpapers

list_theme_wallpapers

List wallpapers for a theme

get_wallpaper_colors

Get dominant wallpaper colors

Tool

Description

list_workspaces

List all workspaces

get_active_workspace

Get the active workspace

switch_workspace

Switch to a workspace

move_workspace_to_monitor

Move workspace to a monitor

create_workspace

Create a new workspace

next_workspace

Go to next workspace

prev_workspace

Go to previous workspace

Tool

Description

list_monitors

List all connected monitors

get_focused_monitor

Get the focused monitor

set_monitor_dpms

Turn monitor on/off

enable_monitor

Enable a monitor

disable_monitor

Disable a monitor

set_monitor_scale

Set monitor scale factor

mirror_monitor

Mirror a monitor

Tool

Description

get_media_status

Get current media playback status

media_play_pause

Toggle play/pause

media_next

Skip to next track

media_previous

Go to previous track

media_stop

Stop playback

media_seek

Seek to position

list_media_players

List active media players

Tool

Description

send_notification

Send a desktop notification

list_notification_history

List notification history

close_all_notifications

Dismiss all notifications

toggle_dnd

Toggle do-not-disturb

get_dnd_status

Get DND status

set_notification_paused

Pause/resume notifications

Tool

Description

get_network_status

Get network connection status

list_wifi_networks

Scan for WiFi networks

connect_wifi

Connect to a WiFi network

disconnect_wifi

Disconnect from WiFi

toggle_wifi

Toggle WiFi on/off

get_ip_addresses

Get IP addresses

Tool

Description

get_clipboard

Get clipboard contents

set_clipboard

Set clipboard contents

list_clipboard_history

List clipboard history

paste_from_history

Paste from history entry

delete_clipboard_entry

Delete a history entry

clear_clipboard_history

Clear all clipboard history

Tool

Description

led_set_color

Set LED color

led_set_brightness

Set LED brightness

led_power

Turn LEDs on/off

led_set_pattern

Set LED pattern

led_effect

Apply LED effect

led_scan

Scan for LED devices

Tool

Description

screenshot_full

Take full screen screenshot

screenshot_monitor

Screenshot a specific monitor

screenshot_region

Screenshot a selected region

screenshot_window

Screenshot a specific window

screenshot_to_clipboard

Screenshot directly to clipboard

Tool

Description

get_bluetooth_status

Get Bluetooth adapter status

list_bluetooth_devices

List paired/available devices

connect_bluetooth

Connect to a device

disconnect_bluetooth

Disconnect from a device

toggle_bluetooth

Toggle Bluetooth on/off

Tool

Description

get_waybar_mode

Get current waybar mode

set_waybar_mode

Set waybar mode

next_waybar_mode

Switch to next mode

prev_waybar_mode

Switch to previous mode

toggle_waybar

Toggle waybar visibility

Tool

Description

hypr_reload

Reload Hyprland config

get_hypr_option

Get a Hyprland option value

set_hypr_option

Set a Hyprland option

get_hypr_binds

List all keybindings

toggle_animations

Toggle animations on/off

Tool

Description

lock_screen

Lock the screen

toggle_idle_inhibitor

Toggle idle inhibitor

toggle_gamemode

Toggle gamemode

get_gamemode_status

Get gamemode status

suspend_system

Suspend the system

Tool

Description

create_macro

Create a reusable macro from tool steps

run_macro

Execute a saved macro

list_macros

List all saved macros

get_macro

Get macro details

delete_macro

Delete a macro

Tool

Description

open_url

Open a URL in the default browser

open_file_manager

Open file manager

open_terminal

Open terminal emulator

trash_file

Move file to trash

show_desktop

Minimize all windows

Tool

Description

get_brightness

Get current brightness

set_brightness

Set brightness level

increase_brightness

Increase brightness

decrease_brightness

Decrease brightness

Tool

Description

get_keyboard_layout

Get current keyboard layout

switch_keyboard_layout

Switch keyboard layout

start_reading_mode

Enter reading mode

stop_reading_mode

Exit reading mode

Tool

Description

start_recording

Start screen recording

stop_recording

Stop screen recording

is_recording

Check if recording is active

start_recording_gif

Record screen as GIF

Tool

Description

set_timer

Set a countdown timer

list_timers

List active timers

cancel_timer

Cancel a timer

cancel_all_timers

Cancel all timers

Tool

Description

read_file

Read file contents

write_file

Write to a file

list_directory

List directory contents

file_info

Get file metadata

Tool

Description

launch_app

Launch a desktop application

list_desktop_apps

List installed .desktop apps

kill_app

Kill an application by name

list_running_apps

List currently running apps

Tool

Description

get_power_profile

Get current power profile

set_power_profile

Set power profile

get_screen_timeout

Get screen timeout setting

get_thermal_info

Get thermal/temperature info

Tool

Description

wa_send_message

Send a WhatsApp message

wa_list_chats

List WhatsApp chats

wa_read_messages

Read messages from a chat

Tool

Description

check_updates

Check for package updates

search_package

Search for a package

list_installed_packages

List installed packages

Tool

Description

pick_color

Pick a color from the screen

pick_color_to_clipboard

Pick color and copy to clipboard


Macros

hypr-tools includes a macro engine that lets you compose multi-step automations from any tool combination. Example:

"Create a macro called 'movie-mode' that:
  1. Sets volume to 80%
  2. Switches to a dark theme
  3. Enables do-not-disturb
  4. Makes the focused window fullscreen"

The AI will use create_macro to save this, and run_macro to execute it later.


Architecture

hypr-tools/
  src/
    index.ts          # MCP server entry point
    utils.ts          # Shared helpers (safeExec, hyprctl)
    tools/
      audio.ts        # 12 tools
      windows.ts      # 14 tools
      projector.ts    # 12 tools
      ... (30 modules total)
  build/              # Compiled JS (ships to npm)
  smithery.yaml       # Smithery marketplace config
  PUBLISH_GUIDE.md    # Publishing instructions

All tools use hyprctl IPC or standard Linux CLI utilities. No external APIs or cloud services required (except WhatsApp which uses a local bridge).


Compatibility

MCP Client

Status

Claude Desktop

Tested

Claude Code

Tested

Cursor

Tested

Cline

Tested

Windsurf

Compatible

Any stdio MCP client

Compatible


Contributing

Issues and pull requests welcome at github.com/0aaryan/hypr-tools.


License

MIT -- see LICENSE.


Author

Aryan Arora (@0aaryan)

Built for AI-native desktop automation on Hyprland/Wayland.

Available Tools

178 tools
cancel_all_timersB
Destructive

Cancel all active timers

Inputs: no named parameters.

cancel_timerB
Destructive

Cancel an active timer by its ID

Inputs: id (required).

check_updatesA
Read-only

Check for available system updates (pacman official + AUR)

Inputs: no named parameters.

clear_clipboard_historyA
Destructive

Wipe the entire clipboard history

Inputs: no named parameters.

close_all_notificationsA

Dismiss all currently visible notifications

Inputs: no named parameters.

close_windowA

Gracefully close the focused window (or by address)

Inputs: address.

connect_bluetoothA

Connect to a paired bluetooth device by MAC address or name

Inputs: device (required).

connect_wifiC

Connect to a WiFi network by SSID

Inputs: ssid (required), password.

create_macroA

Create a new macro or overwrite an existing one. Steps are an array of {tool, params?} objects.

Inputs: name (required), steps (required), description.

create_workspaceB

Switch to the first empty workspace (effectively creates a new workspace)

Inputs: no named parameters.

decrease_brightnessA

Decrease screen brightness by N percent (default 5)

Inputs: step.

decrease_volumeA

Decrease audio output volume by N percent (default 5)

Inputs: step.

delete_clipboard_entryB
Destructive

Delete a specific entry from clipboard history by ID

Inputs: id (required).

delete_macroC
Destructive

Delete a macro by name

Inputs: name (required).

disable_monitorA

Disable a monitor (turns it off and removes from layout)

Inputs: monitor (required).

disconnect_bluetoothB

Disconnect a bluetooth device by MAC address

Inputs: device (required).

disconnect_wifiB

Disconnect from the current WiFi network

Inputs: no named parameters.

enable_monitorA

Enable a disabled monitor with its default settings

Inputs: monitor (required).

file_infoB
Read-only

Get metadata about a file: size, type, modification time

Inputs: path (required).

focus_windowC

Focus a window by its class name or title substring

Inputs: class, title.

get_active_workspaceB
Read-only

Get information about the currently active workspace

Inputs: no named parameters.

get_battery_infoA
Read-only

Get battery percentage, charging state, and time remaining

Inputs: no named parameters.

get_bluetooth_statusA
Read-only

Get bluetooth power state and currently connected devices

Inputs: no named parameters.

get_brightnessA
Read-only

Get current screen brightness as a percentage

Inputs: no named parameters.

get_clipboardA
Read-only

Get current clipboard text content

Inputs: no named parameters.

get_cpu_infoA
Read-only

Get CPU model, usage percentage, temperature, and frequency

Inputs: no named parameters.

get_current_themeA
Read-only

Get the currently active HyDE theme name

Inputs: no named parameters.

get_disk_infoA
Read-only

Get disk usage per mount point

Inputs: no named parameters.

get_dnd_statusB
Read-only

Check if Do Not Disturb mode is enabled

Inputs: no named parameters.

get_focused_monitorB
Read-only

Get the currently focused monitor's details

Inputs: no named parameters.

get_focused_windowB
Read-only

Get details of the currently focused/active window

Inputs: no named parameters.

get_gamemode_statusB
Read-only

Check if gamemode (performance mode) is currently active

Inputs: no named parameters.

get_gpu_infoA
Read-only

Get GPU model, usage, temperature, and VRAM usage

Inputs: no named parameters.

get_hypr_bindsB
Read-only

List all active Hyprland keybindings

Inputs: no named parameters.

get_hypr_optionA
Read-only

Get a Hyprland config option's current value (e.g. 'general:border_size', 'decoration:rounding')

Inputs: option (required).

get_ip_addressesB
Read-only

Get all network interface IP addresses

Inputs: no named parameters.

get_keyboard_layoutA
Read-only

Get the current keyboard layout

Inputs: no named parameters.

get_macroB
Read-only

Get full details of a specific macro

Inputs: name (required).

get_media_statusA
Read-only

Get currently playing track info: title, artist, album, player, status, position

Inputs: no named parameters.

get_memory_infoA
Read-only

Get RAM usage: used, total, available, swap

Inputs: no named parameters.

get_mic_volumeA
Read-only

Get microphone input volume percentage and mute state

Inputs: no named parameters.

get_network_statusA
Read-only

Get current network connection status (WiFi SSID, IP, signal strength, device type)

Inputs: no named parameters.

get_power_profileA
Read-only

Get the current power profile (performance, balanced, power-saver)

Inputs: no named parameters.

get_rofi_styleA
Read-only

Get the current rofi launcher style number

Inputs: no named parameters.

get_screen_timeoutA
Read-only

Get the current screen idle timeout and lock timeout

Inputs: no named parameters.

get_system_infoA
Read-only

Get OS, kernel version, hostname, Hyprland version, and shell

Inputs: no named parameters.

get_thermal_infoA
Read-only

Get CPU and GPU temperatures

Inputs: no named parameters.

get_uptimeA
Read-only

Get system uptime and load averages

Inputs: no named parameters.

get_volumeA
Read-only

Get current audio output volume percentage and mute state

Inputs: no named parameters.

get_wallbash_modeA
Read-only

Get current wallbash color mode (theme/auto/dark/light)

Inputs: no named parameters.

get_wallpaperA
Read-only

Get the file path of the currently active wallpaper

Inputs: no named parameters.

get_wallpaper_colorsA
Read-only

Get the extracted color palette from the current wallpaper (wallbash colors)

Inputs: no named parameters.

get_waybar_modeA
Read-only

Get the currently active waybar layout mode (line number in config.ctl)

Inputs: no named parameters.

group_windowB

Toggle window grouping (tabbed mode) on the focused window

Inputs: no named parameters.

hypr_reloadA

Reload the Hyprland configuration

Inputs: no named parameters.

increase_brightnessA

Increase screen brightness by N percent (default 5)

Inputs: step.

increase_volumeA

Increase audio output volume by N percent (default 5)

Inputs: step.

is_recordingA
Read-only

Check if a screen recording is currently in progress

Inputs: no named parameters.

kill_appB
Destructive

Kill a running application by name or PID

Inputs: pid, name, signal.

kill_windowB
Destructive

Force kill a window by address (use as last resort)

Inputs: address.

launch_appA

Launch an application by name or command (runs detached via hyprctl dispatch exec)

Inputs: command (required).

led_effectA

Run a LED animation effect: rainbow (color cycle), pulse (brightness breathing), or wave (smooth color transition)

Inputs: effect (required), loops.

led_powerC

Turn LED strip on or off

Inputs: on (required).

led_scanA
Read-only

Scan for BLE LED strips nearby

Inputs: no named parameters.

led_set_brightnessB

Set LED strip brightness (0-100%)

Inputs: level (required).

led_set_colorA

Set LED strip to a specific RGB color (0-255 each) or a named color (red, green, blue, white, purple, cyan, yellow, orange, pink, warm, magenta)

Inputs: b, g, r, name.

led_set_patternB

Set LED strip to a built-in animation pattern by index (0-210) or name. Examples: rainbow, strobe, wave, breathing, etc.

Inputs: name, index.

list_audio_sinksA
Read-only

List all audio output devices (speakers, headphones, etc.)

Inputs: no named parameters.

list_audio_sourcesA
Read-only

List all audio input devices (microphones)

Inputs: no named parameters.

list_bluetooth_devicesA
Read-only

List paired and nearby bluetooth devices

Inputs: no named parameters.

list_clipboard_historyC
Read-only

List recent clipboard history entries

Inputs: limit.

list_desktop_appsA
Read-only

List all installed .desktop applications (filterable by name)

Inputs: limit, filter.

list_directoryA
Read-only

List files and directories at a path (sandboxed to home directory)

Inputs: path (required), details.

list_installed_packagesB
Read-only

List explicitly installed packages, optionally filtered by name

Inputs: limit, filter.

list_macrosA
Read-only

List all available macros with their descriptions and steps

Inputs: no named parameters.

list_media_playersA
Read-only

List all active MPRIS2 media players

Inputs: no named parameters.

list_monitorsA
Read-only

List all monitors with resolution, refresh rate, scale, and position

Inputs: no named parameters.

list_notification_historyA
Read-only

Get recent notification history from dunst

Inputs: limit.

list_processesA
Read-only

List running processes, optionally filtered and sorted by CPU or memory usage

Inputs: sort, limit, filter.

list_running_appsA
Read-only

List running GUI applications (from Hyprland's client list)

Inputs: no named parameters.

list_themesB
Read-only

List all installed HyDE themes

Inputs: no named parameters.

list_theme_wallpapersA
Read-only

List all wallpaper files for a specific theme

Inputs: theme (required).

list_timersA
Read-only

List all active timers with their remaining time

Inputs: no named parameters.

list_wallpapersA
Read-only

List all wallpaper files in the current theme directory

Inputs: no named parameters.

list_wifi_networksA
Read-only

Scan and list available WiFi networks with signal strength

Inputs: no named parameters.

list_windowsA
Read-only

List all open windows with title, class, workspace, position, and size

Inputs: no named parameters.

list_workspacesA
Read-only

List all active workspaces with their IDs, names, and window counts

Inputs: no named parameters.

lock_screenA

Lock the screen using the configured screen locker (swaylock/hyprlock)

Inputs: no named parameters.

media_nextB

Skip to the next track

Inputs: player.

media_play_pauseB

Toggle play/pause on the active media player

Inputs: player.

media_previousC

Go to the previous track

Inputs: player.

media_seekB

Seek to a position in the current track (in seconds)

Inputs: position (required), player.

media_stopC

Stop media playback

Inputs: player.

mirror_monitorC

Mirror one monitor to another

Inputs: source (required), target (required).

move_to_scratchpadA

Move the focused window to the special scratchpad workspace

Inputs: no named parameters.

move_windowB

Move a floating window by a pixel delta

Inputs: x (required), y (required).

move_window_to_workspaceB

Move the focused window to a specific workspace number

Inputs: workspace (required), silent.

move_workspace_to_monitorA

Move a workspace to a different monitor

Inputs: monitor (required), workspace (required).

next_themeB

Cycle to the next HyDE theme

Inputs: no named parameters.

next_wallpaperA

Switch to the next wallpaper in the current theme rotation

Inputs: no named parameters.

next_waybar_modeA

Cycle to the next waybar layout mode

Inputs: no named parameters.

next_workspaceB

Switch to the next workspace

Inputs: no named parameters.

open_file_managerC

Open the file manager at a given path

Inputs: path.

open_terminalC

Open a new terminal window, optionally with a command or working directory

Inputs: cwd, title, command.

open_urlB

Open a URL in the default browser

Inputs: url (required).

paste_from_historyA

Copy a specific clipboard history entry to the active clipboard by its ID

Inputs: id (required).

pick_colorA
Read-only

Open an on-screen color picker and return the selected hex color

Inputs: no named parameters.

pick_color_to_clipboardA

Pick a color from the screen and copy the hex value to clipboard

Inputs: no named parameters.

pin_windowA

Toggle always-on-top pin on the focused window

Inputs: no named parameters.

prev_themeB

Cycle to the previous HyDE theme

Inputs: no named parameters.

prev_wallpaperA

Switch to the previous wallpaper in the current theme rotation

Inputs: no named parameters.

prev_waybar_modeA

Cycle to the previous waybar layout mode

Inputs: no named parameters.

prev_workspaceB

Switch to the previous workspace

Inputs: no named parameters.

projector_brightnessC

Set the projector screen brightness (0-255).

Inputs: level (required).

projector_fullscreenA

Enable fullscreen immersive mode on the projector (hide status bar and navigation).

Inputs: no named parameters.

projector_open_urlC

Open a URL on the projector browser.

Inputs: url (required).

projector_reloadA

Reload the current page on the projector browser.

Inputs: no named parameters.

projector_scanA
Read-only

Scan the local network for Android devices that could be projectors. Uses nmap to find devices on port 5555.

Inputs: no named parameters.

projector_screenshotC
Read-only

Take a screenshot of the projector screen and save it locally.

Inputs: output.

projector_setupA

Configure projector connection. Sets IP address, ADB port, Fully Kiosk Browser password and the dashboard URL. Run this first before using other projector tools.

Inputs: ip (required), adb_port, fkb_port, fkb_password, +1 more.

projector_show_dashboardA

Open the configured dashboard URL on the projector in fullscreen.

Inputs: no named parameters.

projector_sleepA

Put the projector screen to sleep (turn off display).

Inputs: no named parameters.

projector_speakC

Make the projector speak text using text-to-speech.

Inputs: text (required).

projector_statusA
Read-only

Check projector connection status. Tests ADB and Fully Kiosk Browser connectivity.

Inputs: no named parameters.

projector_wakeA

Wake up the projector screen (turn on display).

Inputs: no named parameters.

read_fileA
Read-only

Read the contents of a file (sandboxed to home directory). Use for configs, logs, scripts.

Inputs: path (required), max_lines.

resize_windowA

Resize the focused window by a pixel delta

Inputs: width (required), height (required).

run_macroB

Run a named macro (predefined chain of tools). Macros are defined in ~/.config/hypr/macros.json

Inputs: name (required).

screenshot_fullA

Take a screenshot of all monitors and save to ~/Pictures/Screenshots/

Inputs: no named parameters.

screenshot_monitorA

Take a screenshot of the currently focused monitor

Inputs: no named parameters.

screenshot_regionA

Take a screenshot of a user-selected region (opens slurp selector)

Inputs: no named parameters.

screenshot_to_clipboardA

Take a screenshot of a region and copy directly to clipboard (no file saved)

Inputs: no named parameters.

screenshot_windowB

Take a screenshot of the currently focused window

Inputs: no named parameters.

search_packageA
Read-only

Search for a package by name in official repos and AUR

Inputs: query (required).

send_notificationC

Send a desktop notification with title, body, and optional urgency/icon

Inputs: title (required), body, icon, urgency.

set_brightnessA

Set screen brightness to a specific percentage (1-100)

Inputs: percent (required).

set_clipboardC

Copy text to the clipboard

Inputs: text (required).

set_default_sinkA

Set the default audio output device by name or ID

Inputs: sink (required).

set_default_sourceA

Set the default audio input device by name or ID

Inputs: source (required).

set_hypr_optionA

Set a runtime Hyprland config option via keyword (non-persistent, resets on reload)

Inputs: value (required), option (required).

set_mic_volumeB

Set microphone input volume to a specific percentage (0-100)

Inputs: volume (required).

set_monitor_dpmsB

Turn monitor display on or off (DPMS power management)

Inputs: state (required), monitor.

set_monitor_scaleC

Change a monitor's scaling factor

Inputs: scale (required), monitor (required).

set_notification_pausedB

Pause or unpause notification display

Inputs: paused (required).

set_power_profileC

Set the power profile

Inputs: profile (required).

set_rofi_styleB

Set rofi launcher style by number (1-12)

Inputs: style (required).

set_themeA

Switch to a specific HyDE theme by name

Inputs: theme (required).

set_timerA

Set a countdown timer. Sends a desktop notification when it fires.

Inputs: label, minutes, seconds.

set_volumeA

Set audio output volume to a specific percentage (0-150)

Inputs: volume (required).

set_wallbash_modeC

Set wallbash color mode

Inputs: mode (required).

set_wallpaperC

Set wallpaper to a specific image file path

Inputs: path (required).

set_waybar_modeA

Switch to a specific waybar layout by config.ctl line number

Inputs: mode (required).

show_desktopB

Minimize all windows to show the desktop

Inputs: no named parameters.

start_reading_modeC

Start key remapping for reading mode (evremap)

Inputs: no named parameters.

start_recordingA

Start recording the screen to a video file in ~/Videos/Recordings/

Inputs: audio.

start_recording_gifB

Start recording the screen as a GIF file

Inputs: no named parameters.

stop_reading_modeA

Stop key remapping for reading mode

Inputs: no named parameters.

stop_recordingB

Stop the current screen recording

Inputs: no named parameters.

suspend_systemA
Destructive

Suspend the system to RAM (sleep). WARNING: This will suspend your machine immediately.

Inputs: no named parameters.

switch_keyboard_layoutA

Cycle to the next keyboard layout

Inputs: no named parameters.

switch_workspaceB

Switch to a specific workspace by number

Inputs: workspace (required).

toggle_animationsA

Toggle Hyprland animations on or off

Inputs: no named parameters.

toggle_bluetoothA

Toggle bluetooth power on or off

Inputs: no named parameters.

toggle_dndB

Toggle Do Not Disturb mode for notifications

Inputs: no named parameters.

toggle_floatA

Toggle floating mode on the focused window

Inputs: no named parameters.

toggle_fullscreenB

Toggle fullscreen on the focused window

Inputs: mode.

toggle_gamemodeA

Toggle gamemode: disables animations, blur, and other effects for performance

Inputs: no named parameters.

toggle_idle_inhibitorB

Prevent or allow the screen from timing out / going idle

Inputs: no named parameters.

toggle_mic_muteA

Toggle microphone mute on/off

Inputs: no named parameters.

toggle_muteA

Toggle audio output mute on/off

Inputs: no named parameters.

toggle_splitA

Toggle horizontal/vertical split direction for the focused window

Inputs: no named parameters.

toggle_waybarA

Show or hide waybar (toggle visibility)

Inputs: no named parameters.

toggle_wifiB

Toggle WiFi radio on or off

Inputs: no named parameters.

trash_fileA
Destructive

Move a file to trash (recoverable, NOT permanent delete). Uses gio trash.

Inputs: path (required).

wa_list_chatsA
Read-only

List visible WhatsApp chat names from the sidebar via Firefox Bridge

Inputs: no named parameters.

wa_read_messagesB
Read-only

Read the last N messages from a WhatsApp chat via Firefox Bridge

Inputs: chat (required), count.

wa_send_messageA

Send a WhatsApp message via Firefox Bridge. Requires Firefox with WhatsApp Web open and the bridge extension active.

Inputs: chat (required), message (required).

write_fileA

Write content to a file (sandboxed to home directory). Creates parent directories if needed.

Inputs: path (required), content (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 178 tools

    Disambiguation3/5

    Most tools target distinct resources and actions, but the 178-tool surface creates several overlapping areas: list_windows vs list_running_apps, close_window/kill_window vs kill_app, get_network_status vs get_ip_addresses, and led_set_pattern vs led_effect. Descriptions usually clarify the boundaries, but an agent could still misselect in these clusters.

    Naming Consistency3/5

    The dominant pattern is action_resource (get_, set_, list_, toggle_, start_, stop_), but there are many mixed conventions such as hypr_reload, media_play_pause, media_next, screenshot_full, wa_send_message, led_set_color, and projector_setup. The names remain readable, but the convention is not predictable across the whole set.

    Tool Count1/5

    178 tools is an extreme mismatch for a single MCP server, even for a broad Hyprland desktop-automation domain. The surface is far too large to navigate reliably and bundles many unrelated subsystems into one toolset.

    Completeness4/5

    The server covers an unusually broad set of desktop workflows: audio, brightness, clipboard, screenshots, recording, wallpapers/themes, windows, workspaces, monitors, media, network, Bluetooth, system info, packages, Waybar, Hyprland config, files, macros, LEDs, timers, and projector control. Minor lifecycle gaps exist (e.g., workspace deletion, richer window/workspace management), but most domains have workable coverage.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      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
      1
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables any LLM to fully control an Omarchy Linux desktop, including themes, apps, screenshots, reminders, audio, brightness, and Hyprland window tiling, with safety guards on destructive operations.
      108
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      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