io.github.cyanheads

macos-mcp-server

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

communityapplication

Package Details

@cyanheads/macos-mcp-server

0.1.2•https://www.npmjs.com/package/@cyanheads/macos-mcp-server
Transportstdio
Runtimenode

Package Arguments

Positional
Position 0
run
Position 1
start:stdio

Environment Variables

MACOS_SCREENSHOT_DIR(str)

Default directory for screenshot files. Defaults to ~/Desktop when empty.

MACOS_DISPLAY_LAYOUTS(str)
Default:{}

JSON object mapping layout names to displayplacer argument strings for apply_layout.

MCP_LOG_LEVEL(str)
Default:info

Minimum log level for output: debug, info, notice, warning, error.

@cyanheads/macos-mcp-server

0.1.2•https://www.npmjs.com/package/@cyanheads/macos-mcp-server
TransportStreamable HTTP
Runtimenode

Package Arguments

Positional
Position 0
run
Position 1
start:http

Environment Variables

MACOS_SCREENSHOT_DIR(str)

Default directory for screenshot files. Defaults to ~/Desktop when empty.

MACOS_DISPLAY_LAYOUTS(str)
Default:{}

JSON object mapping layout names to displayplacer argument strings for apply_layout.

MCP_HTTP_HOST(str)
Default:127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORT(str)
Default:3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATH(str)
Default:/mcp

The endpoint path for the MCP server.

MCP_AUTH_MODE(str)
Default:none

Authentication mode: none, jwt, or oauth.

MCP_LOG_LEVEL(str)
Default:info

Minimum log level for output: debug, info, notice, warning, error.