Control 19 macOS apps with safe actions, approved AppleScript/JXA, and reusable workflows.
Connect Runs on your machine
claude mcp add mcp-osx -e MCP_OSX_MODE=<MCP_OSX_MODE> -e MCP_OSX_APPS=<MCP_OSX_APPS> -e MCP_OSX_HOME=<MCP_OSX_HOME> -- npx -y [email protected]{
"mcpServers": {
"mcp-osx": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MCP_OSX_MODE": "<MCP_OSX_MODE>",
"MCP_OSX_APPS": "<MCP_OSX_APPS>",
"MCP_OSX_HOME": "<MCP_OSX_HOME>"
}
}
}
}{
"mcpServers": {
"mcp-osx": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MCP_OSX_MODE": "<MCP_OSX_MODE>",
"MCP_OSX_APPS": "<MCP_OSX_APPS>",
"MCP_OSX_HOME": "<MCP_OSX_HOME>"
}
}
}
}{
"servers": {
"mcp-osx": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MCP_OSX_MODE": "<MCP_OSX_MODE>",
"MCP_OSX_APPS": "<MCP_OSX_APPS>",
"MCP_OSX_HOME": "<MCP_OSX_HOME>"
}
}
}
}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
| Name | Description |
|---|---|
MCP_OSX_MODEOptional | full (default) or compact (search_actions + run_action, ~1.2k tokens) |
MCP_OSX_APPSOptional | Comma-separated app groups to expose, e.g. system,safari,spotify |
MCP_OSX_HOMEOptional | Data directory for config and workflows (default ~/.mcp-osx) |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 8 Nov 2026 |
| Last updated | 8 Nov 2026 |
| Registry name | io.github.zaosoula/mcp-osx |
More other servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.