NestDaddy
All servers NestDaddy MCP Blog Sign inTry it free
AI and media

Macos Mcp Server

io.github.cyanheads/macos-mcp-server · v0.4.0

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

Source code Set it up

Connect Runs on your machine

Terminal
claude mcp add macos-mcp-server -e MACOS_SCREENSHOT_DIR=<MACOS_SCREENSHOT_DIR> -e MACOS_DISPLAY_LAYOUTS=<MACOS_DISPLAY_LAYOUTS> -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -- npx -y @cyanheads/[email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "macos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/[email protected]"
      ],
      "env": {
        "MACOS_SCREENSHOT_DIR": "<MACOS_SCREENSHOT_DIR>",
        "MACOS_DISPLAY_LAYOUTS": "<MACOS_DISPLAY_LAYOUTS>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "macos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/[email protected]"
      ],
      "env": {
        "MACOS_SCREENSHOT_DIR": "<MACOS_SCREENSHOT_DIR>",
        "MACOS_DISPLAY_LAYOUTS": "<MACOS_DISPLAY_LAYOUTS>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "macos-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/[email protected]"
      ],
      "env": {
        "MACOS_SCREENSHOT_DIR": "<MACOS_SCREENSHOT_DIR>",
        "MACOS_DISPLAY_LAYOUTS": "<MACOS_DISPLAY_LAYOUTS>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
MACOS_SCREENSHOT_DIR
Optional		Default directory for screenshot files. Defaults to ~/Desktop when empty.
MACOS_DISPLAY_LAYOUTS
Optional		JSON object mapping layout names to displayplacer argument strings for apply_layout.
MCP_LOG_LEVEL
Optional		Minimum log level for output: debug, info, notice, warning, error.

Details

Package@cyanheads/[email protected] (NPM, stdio)
Package@cyanheads/[email protected] (NPM, streamable-http)
First published29 Oct 2026
Last updated29 Oct 2026
Registry nameio.github.cyanheads/macos-mcp-server

More ai and media servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.