displaybuddy-mcp — Claude Code MCP server: control Mac monitors
An MCP server that lets an AI agent change brightness, contrast, input and presets on Mac monitors through DisplayBuddy.
claude mcp add displaybuddy-mcp -- npx -y @biocross/displaybuddy-mcpWhat displaybuddy-mcp does
The server wraps the displaybuddy CLI, which talks to the running DisplayBuddy app over a URL scheme. The chain is short: agent → MCP server → displaybuddy CLI → app → your monitors. Everything stays on the machine.
Nine tools ship with it. displaybuddy_status gives a quick look at every display, displaybuddy_list adds UUID, type and capabilities, while displaybuddy_get and displaybuddy_set read and change brightness, contrast, volume, input and rotation. Presets live in displaybuddy_preset_list and displaybuddy_preset_activate, schedules in displaybuddy_schedule_list and displaybuddy_schedule_toggle, and multi-display sync in displaybuddy_sync.
You need macOS with DisplayBuddy installed and running, the CLI tool from its settings (Settings > General > Install CLI Tool), and Node.js 18+. Skip the CLI step and the server has nothing to call — check that first.
What it helps with
- lower the brightness on every monitor at once
- move an external display to a different input
- apply a saved preset for a specific task
- match several screens to the main display
- turn an automation schedule on or off
Example prompts for the agent
- Which displays are connected right now?
- Drop the brightness on all monitors to 30%
- Activate my Night Mode preset
How to install displaybuddy-mcp
Platform CLI
claude mcp add displaybuddy-mcp -- npx -y @biocross/displaybuddy-mcpPlatform CLI
codex mcp add displaybuddy-mcp -- npx -y @biocross/displaybuddy-mcpConfig file
{
"mcpServers": {
"displaybuddy-mcp": {
"command": "npx",
"args": [
"-y",
"@biocross/displaybuddy-mcp"
]
}
}
}Config file
{
"servers": {
"displaybuddy-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@biocross/displaybuddy-mcp"
]
}
}
}Platform CLI
gemini mcp add displaybuddy-mcp npx -y @biocross/displaybuddy-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about displaybuddy-mcp
How do I install displaybuddy-mcp in Claude Code?
Run claude mcp add displaybuddy-mcp -- npx -y @biocross/displaybuddy-mcp. Make sure DisplayBuddy is running and its CLI tool is installed first.
What does displaybuddy-mcp do?
It gives an agent control over Mac monitors: brightness, contrast, volume, input and rotation, plus presets, schedules and display sync.
What does the server need to run?
macOS with DisplayBuddy running, the CLI tool installed from the app settings, and Node.js 18+. All operations are local.
