About io.github.biocross/displaybuddy-mcp
io.github.biocross/displaybuddy-mcp is an MCP server in the Science category: mCP server for controlling Mac monitors via DisplayBuddy — adjust brightness and more.
Install
claude mcp add io-github-biocross-displaybuddy-mcp -- npx -y @biocross/displaybuddy-mcpnpx -y @biocross/displaybuddy-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (9)
displaybuddy_getGet properties of a specific display
Parameters not published.
displaybuddy_listFull display details including UUID, type, capabilities
Parameters not published.
displaybuddy_preset_activateActivate a preset (with optional delay)
Parameters not published.
displaybuddy_preset_listList saved presets
Parameters not published.
displaybuddy_schedule_listList automation schedules
Parameters not published.
displaybuddy_schedule_toggleEnable or disable a schedule
Parameters not published.
displaybuddy_setSet brightness, contrast, volume, input, rotation
Parameters not published.
displaybuddy_statusQuick overview of all displays (call this first)
Parameters not published.
displaybuddy_syncCheck/enable/disable multi-display sync
Parameters not published.
Ask AI
Ask AI about io.github.biocross/displaybuddy-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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+
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 claude
Available Tools
| Tool | Description |
|---|---|
displaybuddy_status |
Quick overview of all displays (call this first) |
displaybuddy_list |
Full display details including UUID, type, capabilities |
displaybuddy_get |
Get properties of a specific display |
displaybuddy_set |
Set brightness, contrast, volume, input, rotation |
displaybuddy_preset_list |
List saved presets |
displaybuddy_preset_activate |
Activate a preset (with optional delay) |
displaybuddy_schedule_list |
List automation schedules |
displaybuddy_schedule_toggle |
Enable or disable a schedule |
displaybuddy_sync |
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 Monitors
Development
npm install
npm run build
# Test with MCP Inspector
npx -y @modelcontextprotocol/inspector node ./build/index.js
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.