biocross avatar

Displaybuddy Mcp

biocross/displaybuddy-mcp

Wraps the DisplayBuddy CLI to give Claude control over your Mac's external monitors without leaving the keyboard. Exposes tools for adjusting brightness, contrast, volume, and input source across connected displays, plus activating saved presets and toggling automation schedules. You can sync settings across multiple monitors or target specific displays by UUID. Everything runs locally through DisplayBuddy's URL scheme, so you need the app installed and its CLI tool set up first. Useful when you're already chatting with Claude about your workflow and want to adjust your display setup without breaking focus to hunt for hardware buttons or menu bar controls.

GitHub stars
2
tools
9
transport
STDIO
last updated
Mar 15, 2026

Tools

9 tools

Public tool metadata for what this MCP can expose to an agent.

displaybuddy_statusQuick overview of all displays (call this first)

Quick overview of all displays (call this first)

No parameter schema in public metadata yet.

displaybuddy_listFull display details including UUID, type, capabilities

Full display details including UUID, type, capabilities

No parameter schema in public metadata yet.

displaybuddy_getGet properties of a specific display

Get properties of a specific display

No parameter schema in public metadata yet.

displaybuddy_setSet brightness, contrast, volume, input, rotation

Set brightness, contrast, volume, input, rotation

No parameter schema in public metadata yet.

displaybuddy_preset_listList saved presets

List saved presets

No parameter schema in public metadata yet.

displaybuddy_preset_activateActivate a preset (with optional delay)

Activate a preset (with optional delay)

No parameter schema in public metadata yet.

displaybuddy_schedule_listList automation schedules

List automation schedules

No parameter schema in public metadata yet.

displaybuddy_schedule_toggleEnable or disable a schedule

Enable or disable a schedule

No parameter schema in public metadata yet.

displaybuddy_syncCheck/enable/disable multi-display sync

Check/enable/disable multi-display sync

No parameter schema in public metadata yet.

Sponsors

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

  1. macOS with DisplayBuddy installed and running
  2. DisplayBuddy CLI installed: open DisplayBuddy > Settings > General > Install CLI Tool
  3. 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


View the full README on GitHub

Details

Repository
github.com/biocross/displaybuddy-mcp
Package
@biocross/displaybuddy-mcp
Transport
STDIO
Registry
MCP registry, active