Macos-mcp-server MCP Server

Macos-mcp-server is an MCP integration. Control macOS system settings, apps, windows, audio, displays, screenshots, and Focus mode via MCP.

Packages and local setup

The published npm package is @cyanheads/macos-mcp-server, version 0.2.0. Its declared MCP transport is stdio.

The package declares 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..

This package has launch arguments in its registry record. Use the maintainer’s configuration for those arguments rather than launching it with only the package name.

The published npm package is @cyanheads/macos-mcp-server, version 0.2.0. Its declared MCP transport is streamable-http.

The package declares 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_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.; MCP_LOG_LEVEL: Minimum log level for output: debug, info, notice, warning, error..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.2.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.