Skip to main content
Glama
displaybuddy-mcp

displaybuddy-mcp

by biocross

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+

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 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

Available Tools

9 tools
displaybuddy_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

    A3.9/5.0

    Scored across 9 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools follow the pattern 'displaybuddy_<verb>' with consistent lowercase snake_case. Verbs like get, list, activate, set, status, sync are used predictably.

    Tool Count5/5

    9 tools is well-scoped for display management. Covers discovery, property setting, presets, schedules, and sync without unnecessary extras.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to automate macOS desktop tasks including mouse control, keyboard input, screenshots, window management, and UI interaction.
      417
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to control macOS desktop apps via screenshots, mouse clicks, keyboard input, accessibility queries, and AppleScript.
      11
      8 npm
      MIT