Displaybuddy Mcp

io.github.biocrossPublished by GitHub account biocrossv1.0.0Updated Nov 3, 2026

MCP server for controlling Mac monitors via DisplayBuddy — adjust brightness and more.

VerifiedSTDIODesktop onlyProductivity & WorkflowMedia & Design

Overview

AI-generated overview

Local MCP server that lets an AI assistant control Mac monitors through DisplayBuddy: brightness, contrast, volume, input source, presets and sync.

What you can do
  • Inspect displays: get a status overview, list full display details such as UUID, type and capabilities, and read properties of a specific display
  • Change display settings: set brightness, contrast, volume, input source and rotation
  • Manage presets: list saved presets and activate one, optionally with a delay
  • Manage schedules: list automation schedules and enable or disable them
  • Control multi-display sync: check, enable or disable syncing across displays
When to use it
Useful on a Mac with multiple monitors when you want to adjust brightness, contrast, volume or input source, switch presets, or sync displays by asking the assistant instead of using the DisplayBuddy app.
Requirements
macOS with the DisplayBuddy app installed and running, the DisplayBuddy CLI installed from the app's settings, and Node.js 18 or later for the npm package. Runs locally over stdio; no accounts, API keys or environment variables are declared.
Before you install
It changes real hardware settings on your monitors (brightness, contrast, volume, input source, rotation) and can activate presets and toggle schedules, so assistant actions take effect immediately. It depends on the DisplayBuddy app and its CLI being present; the README states all operations are local and no data leaves the machine.

Installation

In SourceWeft

  1. Open Displaybuddy Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

json
{  "mcpServers": {    "displaybuddy": {      "command": "npx",      "args": ["-y", "displaybuddy-mcp"]    }  }}

Cursor

Add to your MCP settings:

json
{  "mcpServers": {    "displaybuddy": {      "command": "npx",      "args": ["-y", "displaybuddy-mcp"]    }  }}

Smithery

bash
npx -y @smithery/cli install displaybuddy-mcp --client claude

Available Tools

ToolDescription
displaybuddy_statusQuick overview of all displays (call this first)
displaybuddy_listFull display details including UUID, type, capabilities
displaybuddy_getGet properties of a specific display
displaybuddy_setSet brightness, contrast, volume, input, rotation
displaybuddy_preset_listList saved presets
displaybuddy_preset_activateActivate a preset (with optional delay)
displaybuddy_schedule_listList automation schedules
displaybuddy_schedule_toggleEnable or disable a schedule
displaybuddy_syncCheck/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

bash
npm installnpm run build
# Test with MCP Inspectornpx -y @modelcontextprotocol/inspector node ./build/index.js

License

MIT

Source: README.md at commit 6dc03c4

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts