MCP server for controlling Mac monitors via DisplayBuddy — adjust brightness and more.
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.
Add to your claude_desktop_config.json:
{
"mcpServers": {
"displaybuddy": {
"command": "npx",
"args": ["-y", "displaybuddy-mcp"]
}
}
}
Add to your MCP settings:
{
"mcpServers": {
"displaybuddy": {
"command": "npx",
"args": ["-y", "displaybuddy-mcp"]
}
}
}
npx -y @smithery/cli install displaybuddy-mcp --client claude
| 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 |
Once connected, you can ask your AI assistant things like:
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
npm install
npm run build
# Test with MCP Inspector
npx -y @modelcontextprotocol/inspector node ./build/index.js
MIT
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y @biocross/displaybuddy-mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-biocross-displaybuddy-mcp": {
"command": "npx",
"args": [
"-y",
"@biocross/displaybuddy-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup reference@biocross/displaybuddy-mcpnpmio.github.biocross/displaybuddy-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.