Package

macos-mcp-server

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

io.github.cyanheads/macos-mcp-serverSource repository

Version0.4.0latest catalog version

ConnectionPackagenpm

PublishedOct 29, 2026catalog

UpdatedOct 29, 2026catalog

Overview

What this server provides

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

Install

Package 1npm

@cyanheads/macos-mcp-server0.4.0

Runtime npxTransport stdio

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

Package 2npm

@cyanheads/macos-mcp-server0.4.0

Runtime npxTransport streamable-http

http://localhost:3010/mcp

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

View server metadata

Namespace