Skip to content
MCP server

Macos MCP Server

Control macOS settings, apps, windows, audio, Music, displays, screenshots, and Focus…

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.4.0
Listing updated
4 days ago

About Macos MCP Server

Macos MCP Server is an open-source MCP server for design and media. It can run locally on your machine or as a hosted remote server.

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

Install

Run in a terminal

claude mcp add macos-mcp-server -- npx -y @cyanheads/macos-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "macos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/macos-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "macos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/macos-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "macos-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/macos-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "macos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/macos-mcp-server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "macos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/macos-mcp-server"
      ]
    }
  }
}

Configuration

  • MACOS_SCREENSHOT_DIRDefault directory for screenshot files. Defaults to ~/Desktop when empty.
  • MACOS_DISPLAY_LAYOUTSJSON object mapping layout names to displayplacer argument strings for apply_layout.
  • MCP_LOG_LEVELMinimum log level for output: debug, info, notice, warning, error.
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • MACOS_SCREENSHOT_DIRDefault directory for screenshot files. Defaults to ~/Desktop when empty.
  • MACOS_DISPLAY_LAYOUTSJSON object mapping layout names to displayplacer argument strings for apply_layout.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode: none, jwt, or oauth.
  • MCP_LOG_LEVELMinimum log level for output: debug, info, notice, warning, error.

Pricing

Open source

Macos MCP Server FAQ

Is Macos MCP Server free?

Yes. Macos MCP Server is open source, so you can use and self-host it for free.

How do I add Macos MCP Server to Claude Code?

Run this command in your terminal: claude mcp add macos-mcp-server -- npx -y @cyanheads/macos-mcp-server

What are the best alternatives to Macos MCP Server?

The closest alternatives to Macos MCP Server are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to Macos MCP Server

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media