displaybuddy-mcp
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., "@displaybuddy-mcp dim all monitors to 50%"
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.
DisplayBuddy MCP Server
An MCP (Model Context Protocol) server that lets AI agents control Mac monitors via DisplayBuddy — adjust brightness, contrast, volume, input source, apply presets, sync displays, and more.
Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP-compatible client.
Prerequisites
macOS with DisplayBuddy installed and running
DisplayBuddy CLI installed: open DisplayBuddy > Settings > General > Install CLI Tool
Node.js 18+
Related MCP server: DDC/CI Control Bridge
Installation
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"displaybuddy": {
"command": "npx",
"args": ["-y", "displaybuddy-mcp"]
}
}
}Cursor
Add to your MCP settings:
{
"mcpServers": {
"displaybuddy": {
"command": "npx",
"args": ["-y", "displaybuddy-mcp"]
}
}
}Smithery
npx -y @smithery/cli install displaybuddy-mcp --client claudeAvailable Tools
Tool | Description |
| Quick overview of all displays (call this first) |
| Full display details including UUID, type, capabilities |
| Get properties of a specific display |
| Set brightness, contrast, volume, input, rotation |
| List saved presets |
| Activate a preset (with optional delay) |
| List automation schedules |
| Enable or disable a schedule |
| Check/enable/disable multi-display sync |
Example Prompts
Once connected, you can ask your AI assistant things like:
"Dim all my monitors to 30%"
"What displays are connected?"
"Switch my Dell monitor to HDMI"
"Activate my Night Mode preset"
"Sync all displays to my main monitor"
"Turn up the brightness on my external display"
"Set up my coding environment — brightness 70, contrast 60"
How It Works
The MCP server wraps the displaybuddy CLI, which communicates with the running DisplayBuddy app via URL scheme. All operations are local — no data leaves your machine.
AI Agent → MCP Server → displaybuddy CLI → DisplayBuddy App → Your MonitorsDevelopment
npm install
npm run build
# Test with MCP Inspector
npx -y @modelcontextprotocol/inspector node ./build/index.jsLicense
MIT
Available Tools
9 toolsdisplaybuddy_getB
Get current properties of a specific display.
Inputs: display (required), property.
displaybuddy_listA
List all connected displays with full details including UUID, type, control mode, max values, and capability flags.
Inputs: no named parameters.
displaybuddy_preset_activateB
Activate a saved display preset by name.
Inputs: name (required), delay.
displaybuddy_preset_listA
List all saved display presets.
Inputs: no named parameters.
displaybuddy_schedule_listA
List all display automation schedules with their trigger type, preset, and enabled status.
Inputs: no named parameters.
displaybuddy_schedule_toggleB
Enable or disable a display automation schedule.
Inputs: id (required), enabled (required).
displaybuddy_setA
Set display properties like brightness, contrast, volume, input source, or rotation. Can target a specific display by name or all displays at once.
Inputs: display, all, brightness, contrast, +4 more.
displaybuddy_statusA
Get a quick overview of all connected displays with their current brightness, contrast, volume, and input source. Always call this first to discover display names before using other tools.
Inputs: no named parameters.
displaybuddy_syncA
Manage display sync. Sync makes all displays follow one source display's brightness, contrast, and volume. Can check status, enable with a source display, or disable.
Inputs: action (required), display.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Every tool has a clearly distinct purpose: get vs list, set vs status, preset actions, schedule actions, sync. No overlapping functionality, agents can easily select the correct tool.
All tools follow the pattern 'displaybuddy_<verb>' with consistent lowercase snake_case. Verbs like get, list, activate, set, status, sync are used predictably.
9 tools is well-scoped for display management. Covers discovery, property setting, presets, schedules, and sync without unnecessary extras.
Covers core operations well, but lacks tools to create or delete presets and schedules. Since the server can activate/toggle existing ones, the gap is minor.
Maintenance
Related MCP Connectors
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
- DNS-DATA RemoteDeprecatedcom.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
Deploy sims to any screen. Control your displays with Claude.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to automate macOS desktop tasks including mouse control, keyboard input, screenshots, window management, and UI interaction.417MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control monitor settings (brightness, contrast, input source) via DDC/CI protocol, with support for MQTT integration.6MIT
- AlicenseAqualityDmaintenanceEnables AI agents to manage macOS audio routing, device switching, volume control, and multi-zone playback.16MIT
- AlicenseAqualityDmaintenanceEnables AI agents to control macOS desktop apps via screenshots, mouse clicks, keyboard input, accessibility queries, and AppleScript.118 npmMIT