Back to Browse

Displaybuddy MCP Server

Developer ToolsModerate7.7MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

7.7
Moderate7.7Low Risk

Valid MCP server (2 strong, 4 medium validity signals). 2 known CVEs in dependencies (0 critical, 2 high severity) ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

3 files analyzed · 3 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-biocross-displaybuddy-mcp": {
      "args": [
        "-y",
        "displaybuddy-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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

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

npm install
npm run build

# Test with MCP Inspector
npx -y @modelcontextprotocol/inspector node ./build/index.js

License

MIT

Reviews

No reviews yet

Be the first to review this server!