hypr-tools
Controls Android projectors/tablets over ADB Wi-Fi, including setup/scan, wake/sleep, opening URLs or dashboards, fullscreen, brightness, reload, screenshots, and text-to-speech.
Provides Bluetooth device management via bluetoothctl, enabling connections to Bluetooth headphones and other devices.
Provides control of the Hyprland compositor via hyprctl, covering windows, workspaces, monitors, themes, wallpapers, screenshots, and related desktop automation.
Provides Linux desktop automation and system monitoring through local Linux utilities, including audio, brightness, clipboard, notifications, network, media, and system information.
Enables desktop automation on Wayland/Hyprland desktops, including window management, workspaces, monitors, screenshots, screen recording, and clipboard operations.
Provides WhatsApp Web automation tools through a local Firefox bridge extension.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@hypr-tools turn my volume down to 30% and take a screenshot of my current window"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Why hypr-tools?
178 tools, 30 categories -- the largest Hyprland MCP server available
Zero config --
npx -y github:0aaryan/hypr-toolsand you're runningNo cloud dependencies -- everything runs locally via
hyprctl, PipeWire, and standard Linux toolsMacro 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-toolsOr run directly:
npx -y github:0aaryan/hypr-toolsClaude 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.jsRequirements
Hyprland compositor (Wayland)
Linux (Arch, NixOS, Fedora, etc.)
Node.js >= 18
System utilities (most come pre-installed with Hyprland):
pactl(PulseAudio/PipeWire) -- audiobrightnessctl-- brightnesswl-clipboard-- clipboardgrim+slurp-- screenshotswf-recorder-- screen recordinghyprctl-- Hyprland IPCnmcli-- networkbluetoothctl-- Bluetoothplayerctl-- medianotify-send-- notifications
Configuration
Everything works out of the box. A few optional tools need hardware or extra setup:
Tools | What they need |
| A BLE LED strip (LEDDMX / ELK-BLEDOM family) and |
| An Android projector with ADB over Wi-Fi, optionally Fully Kiosk Browser. Run |
| WhatsApp Web open in Firefox with a local bridge extension. Set |
theme, wallpaper, wallbash | HyDE. On other Hyprland setups these tools return an error. |
voice scripts |
|
Tool Categories (178 tools)
Tool | Description |
| Get current audio output volume and mute state |
| Set audio output volume (0-150%) |
| Increase volume by N percent |
| Decrease volume by N percent |
| Toggle audio output mute |
| Get microphone volume and mute state |
| Set microphone volume |
| Toggle microphone mute |
| List all audio output devices |
| Set default audio output device |
| List all audio input devices |
| Set default audio input device |
Tool | Description |
| List all open windows with details |
| Get the currently focused window |
| Focus a window by class or title |
| Gracefully close a window |
| Force kill a window |
| Toggle floating mode |
| Toggle fullscreen mode |
| Pin window on all workspaces |
| Move window to a workspace |
| Resize a window |
| Move a window |
| Toggle split direction |
| Group/ungroup window |
| Move window to scratchpad |
Tool | Description |
| Configure projector IP and credentials |
| Get projector status |
| Open a URL on the projector |
| Show dashboard on projector |
| Wake up the projector |
| Put projector to sleep |
| Toggle fullscreen on projector |
| Set projector brightness |
| Reload current page |
| Take a screenshot on projector |
| Text-to-speech on projector |
| Scan for projectors on network |
Tool | Description |
| Get the active theme |
| Set a theme by name |
| Switch to next theme |
| Switch to previous theme |
| List all available themes |
| Get wallbash color mode |
| Set wallbash color mode |
| Get current rofi style |
| Set rofi launcher style |
Tool | Description |
| CPU usage and details |
| GPU information |
| RAM usage |
| Disk usage |
| Battery status |
| System uptime |
| Full system overview |
| List running processes |
Tool | Description |
| Get current wallpaper path |
| Set wallpaper by path |
| Switch to next wallpaper |
| Switch to previous wallpaper |
| List all wallpapers |
| List wallpapers for a theme |
| Get dominant wallpaper colors |
Tool | Description |
| List all workspaces |
| Get the active workspace |
| Switch to a workspace |
| Move workspace to a monitor |
| Create a new workspace |
| Go to next workspace |
| Go to previous workspace |
Tool | Description |
| List all connected monitors |
| Get the focused monitor |
| Turn monitor on/off |
| Enable a monitor |
| Disable a monitor |
| Set monitor scale factor |
| Mirror a monitor |
Tool | Description |
| Get current media playback status |
| Toggle play/pause |
| Skip to next track |
| Go to previous track |
| Stop playback |
| Seek to position |
| List active media players |
Tool | Description |
| Send a desktop notification |
| List notification history |
| Dismiss all notifications |
| Toggle do-not-disturb |
| Get DND status |
| Pause/resume notifications |
Tool | Description |
| Get network connection status |
| Scan for WiFi networks |
| Connect to a WiFi network |
| Disconnect from WiFi |
| Toggle WiFi on/off |
| Get IP addresses |
Tool | Description |
| Get clipboard contents |
| Set clipboard contents |
| List clipboard history |
| Paste from history entry |
| Delete a history entry |
| Clear all clipboard history |
Tool | Description |
| Set LED color |
| Set LED brightness |
| Turn LEDs on/off |
| Set LED pattern |
| Apply LED effect |
| Scan for LED devices |
Tool | Description |
| Take full screen screenshot |
| Screenshot a specific monitor |
| Screenshot a selected region |
| Screenshot a specific window |
| Screenshot directly to clipboard |
Tool | Description |
| Get Bluetooth adapter status |
| List paired/available devices |
| Connect to a device |
| Disconnect from a device |
| Toggle Bluetooth on/off |
Tool | Description |
| Get current waybar mode |
| Set waybar mode |
| Switch to next mode |
| Switch to previous mode |
| Toggle waybar visibility |
Tool | Description |
| Reload Hyprland config |
| Get a Hyprland option value |
| Set a Hyprland option |
| List all keybindings |
| Toggle animations on/off |
Tool | Description |
| Lock the screen |
| Toggle idle inhibitor |
| Toggle gamemode |
| Get gamemode status |
| Suspend the system |
Tool | Description |
| Create a reusable macro from tool steps |
| Execute a saved macro |
| List all saved macros |
| Get macro details |
| Delete a macro |
Tool | Description |
| Open a URL in the default browser |
| Open file manager |
| Open terminal emulator |
| Move file to trash |
| Minimize all windows |
Tool | Description |
| Get current brightness |
| Set brightness level |
| Increase brightness |
| Decrease brightness |
Tool | Description |
| Get current keyboard layout |
| Switch keyboard layout |
| Enter reading mode |
| Exit reading mode |
Tool | Description |
| Start screen recording |
| Stop screen recording |
| Check if recording is active |
| Record screen as GIF |
Tool | Description |
| Set a countdown timer |
| List active timers |
| Cancel a timer |
| Cancel all timers |
Tool | Description |
| Read file contents |
| Write to a file |
| List directory contents |
| Get file metadata |
Tool | Description |
| Launch a desktop application |
| List installed .desktop apps |
| Kill an application by name |
| List currently running apps |
Tool | Description |
| Get current power profile |
| Set power profile |
| Get screen timeout setting |
| Get thermal/temperature info |
Tool | Description |
| Send a WhatsApp message |
| List WhatsApp chats |
| Read messages from a chat |
Tool | Description |
| Check for package updates |
| Search for a package |
| List installed packages |
Tool | Description |
| Pick a color from the screen |
| 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 instructionsAll 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 toolscancel_all_timersBDestructive
Cancel all active timers
Inputs: no named parameters.
cancel_timerBDestructive
Cancel an active timer by its ID
Inputs: id (required).
check_updatesARead-only
Check for available system updates (pacman official + AUR)
Inputs: no named parameters.
clear_clipboard_historyADestructive
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_entryBDestructive
Delete a specific entry from clipboard history by ID
Inputs: id (required).
delete_macroCDestructive
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_infoBRead-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_workspaceBRead-only
Get information about the currently active workspace
Inputs: no named parameters.
get_battery_infoARead-only
Get battery percentage, charging state, and time remaining
Inputs: no named parameters.
get_bluetooth_statusARead-only
Get bluetooth power state and currently connected devices
Inputs: no named parameters.
get_brightnessARead-only
Get current screen brightness as a percentage
Inputs: no named parameters.
get_clipboardARead-only
Get current clipboard text content
Inputs: no named parameters.
get_cpu_infoARead-only
Get CPU model, usage percentage, temperature, and frequency
Inputs: no named parameters.
get_current_themeARead-only
Get the currently active HyDE theme name
Inputs: no named parameters.
get_disk_infoARead-only
Get disk usage per mount point
Inputs: no named parameters.
get_dnd_statusBRead-only
Check if Do Not Disturb mode is enabled
Inputs: no named parameters.
get_focused_monitorBRead-only
Get the currently focused monitor's details
Inputs: no named parameters.
get_focused_windowBRead-only
Get details of the currently focused/active window
Inputs: no named parameters.
get_gamemode_statusBRead-only
Check if gamemode (performance mode) is currently active
Inputs: no named parameters.
get_gpu_infoARead-only
Get GPU model, usage, temperature, and VRAM usage
Inputs: no named parameters.
get_hypr_bindsBRead-only
List all active Hyprland keybindings
Inputs: no named parameters.
get_hypr_optionARead-only
Get a Hyprland config option's current value (e.g. 'general:border_size', 'decoration:rounding')
Inputs: option (required).
get_ip_addressesBRead-only
Get all network interface IP addresses
Inputs: no named parameters.
get_keyboard_layoutARead-only
Get the current keyboard layout
Inputs: no named parameters.
get_macroBRead-only
Get full details of a specific macro
Inputs: name (required).
get_media_statusARead-only
Get currently playing track info: title, artist, album, player, status, position
Inputs: no named parameters.
get_memory_infoARead-only
Get RAM usage: used, total, available, swap
Inputs: no named parameters.
get_mic_volumeARead-only
Get microphone input volume percentage and mute state
Inputs: no named parameters.
get_network_statusARead-only
Get current network connection status (WiFi SSID, IP, signal strength, device type)
Inputs: no named parameters.
get_power_profileARead-only
Get the current power profile (performance, balanced, power-saver)
Inputs: no named parameters.
get_rofi_styleARead-only
Get the current rofi launcher style number
Inputs: no named parameters.
get_screen_timeoutARead-only
Get the current screen idle timeout and lock timeout
Inputs: no named parameters.
get_system_infoARead-only
Get OS, kernel version, hostname, Hyprland version, and shell
Inputs: no named parameters.
get_thermal_infoARead-only
Get CPU and GPU temperatures
Inputs: no named parameters.
get_uptimeARead-only
Get system uptime and load averages
Inputs: no named parameters.
get_volumeARead-only
Get current audio output volume percentage and mute state
Inputs: no named parameters.
get_wallbash_modeARead-only
Get current wallbash color mode (theme/auto/dark/light)
Inputs: no named parameters.
get_wallpaperARead-only
Get the file path of the currently active wallpaper
Inputs: no named parameters.
get_wallpaper_colorsARead-only
Get the extracted color palette from the current wallpaper (wallbash colors)
Inputs: no named parameters.
get_waybar_modeARead-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_recordingARead-only
Check if a screen recording is currently in progress
Inputs: no named parameters.
kill_appBDestructive
Kill a running application by name or PID
Inputs: pid, name, signal.
kill_windowBDestructive
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_scanARead-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_sinksARead-only
List all audio output devices (speakers, headphones, etc.)
Inputs: no named parameters.
list_audio_sourcesARead-only
List all audio input devices (microphones)
Inputs: no named parameters.
list_bluetooth_devicesARead-only
List paired and nearby bluetooth devices
Inputs: no named parameters.
list_clipboard_historyCRead-only
List recent clipboard history entries
Inputs: limit.
list_desktop_appsARead-only
List all installed .desktop applications (filterable by name)
Inputs: limit, filter.
list_directoryARead-only
List files and directories at a path (sandboxed to home directory)
Inputs: path (required), details.
list_installed_packagesBRead-only
List explicitly installed packages, optionally filtered by name
Inputs: limit, filter.
list_macrosARead-only
List all available macros with their descriptions and steps
Inputs: no named parameters.
list_media_playersARead-only
List all active MPRIS2 media players
Inputs: no named parameters.
list_monitorsARead-only
List all monitors with resolution, refresh rate, scale, and position
Inputs: no named parameters.
list_notification_historyARead-only
Get recent notification history from dunst
Inputs: limit.
list_processesARead-only
List running processes, optionally filtered and sorted by CPU or memory usage
Inputs: sort, limit, filter.
list_running_appsARead-only
List running GUI applications (from Hyprland's client list)
Inputs: no named parameters.
list_themesBRead-only
List all installed HyDE themes
Inputs: no named parameters.
list_theme_wallpapersARead-only
List all wallpaper files for a specific theme
Inputs: theme (required).
list_timersARead-only
List all active timers with their remaining time
Inputs: no named parameters.
list_wallpapersARead-only
List all wallpaper files in the current theme directory
Inputs: no named parameters.
list_wifi_networksARead-only
Scan and list available WiFi networks with signal strength
Inputs: no named parameters.
list_windowsARead-only
List all open windows with title, class, workspace, position, and size
Inputs: no named parameters.
list_workspacesARead-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_colorARead-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_scanARead-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_screenshotCRead-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_statusARead-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_fileARead-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_packageARead-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_systemADestructive
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_fileADestructive
Move a file to trash (recoverable, NOT permanent delete). Uses gio trash.
Inputs: path (required).
wa_list_chatsARead-only
List visible WhatsApp chat names from the sidebar via Firefox Bridge
Inputs: no named parameters.
wa_read_messagesBRead-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
Scored across 178 tools
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.
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.
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.
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
Related MCP Connectors
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
A cloud Linux desktop for your AI: browse, click, type, read the screen and run commands.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables LLMs to capture screenshots, inspect windows, and interact with the Hyprland desktop environment through mouse clicks and keyboard input.1-
- AlicenseAqualityCmaintenanceEnables 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.351MIT
- AlicenseBqualityBmaintenanceEnables 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.1081MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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