io.github.cyanheads/macos-mcp-server MCP Server

io.github.cyanheads/macos-mcp-server

Repository Registry

What is the io.github.cyanheads/macos-mcp-server MCP server?

Control macOS system settings, apps, windows, audio, displays, screenshots, and Focus mode via MCP.

How to install io.github.cyanheads/macos-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MACOS_SCREENSHOT_DIR
Default directory for screenshot files. Defaults to ~/Desktop when empty.
MACOS_DISPLAY_LAYOUTS
JSON object mapping layout names to displayplacer argument strings for apply_layout.
MCP_LOG_LEVEL
Minimum log level for output: debug, info, notice, warning, error.
MCP_HTTP_HOST
The hostname for the HTTP server.
MCP_HTTP_PORT
The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH
The endpoint path for the MCP server.
MCP_AUTH_MODE
Authentication mode: none, jwt, or oauth.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "macos-mcp-server": {
      "command": "node",
      "args": [
        "-y",
        "@cyanheads/macos-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "MACOS_SCREENSHOT_DIR": "<YOUR_MACOS_SCREENSHOT_DIR>",
        "MACOS_DISPLAY_LAYOUTS": "<YOUR_MACOS_DISPLAY_LAYOUTS>",
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

Related MCP servers

io.github.cyanheads/mailchimp-mcp-server

Active

Mailchimp via MCP: draft, test, and send campaigns; manage audiences and subscribers; pull reports.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/mcp-ts-core

Active

Agent-native TypeScript framework for building MCP servers with declarative definitions, auth, storage, and OpenTelemetry.

145

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/mcp-ts-template

Active

TypeScript framework for building MCP servers with declarative tools, auth, storage, and observability.

145

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/medical-codes-mcp-server

Active

Offline US medical code lookup and crosswalk — ICD-10-CM/PCS, HCPCS Level II, RxNorm. Keyless.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/met-museum-mcp-server

Active

Search the Met collection, browse by department or update date, fetch full records and CC0 images.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/musicbrainz-mcp-server

Active

Search MusicBrainz artists, releases, works, labels; resolve ISRC/ISWC/barcode; fetch cover art.

TypeScript

Apache-2.0

View repository →