macOS (osascript) MCP Server

by zaosoula Your server? Claim it

local only

macOS (osascript) runs on your own machine — the client starts it, so there is no endpoint to ping. Last commit 8 Nov 2026.

Control 19 macOS apps with safe actions, approved AppleScript/JXA, and reusable workflows.

—

Installs / week

npm · mcp-osx

Stars

0 open issues

8 Nov 2026

Last commit

2 releases in 90 days

MIT

License

TypeScript

Nothing serious here today

Today is the operative word: we check macOS (osascript) every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add mcp-osx -- npx -y mcp-osx

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-osx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-osx"
      ]
    }
  }
}

~/.codex/config.toml

[mcp_servers.mcp-osx]
command = "npx"
args = ["-y", "mcp-osx"]

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-osx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-osx"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mcp-osx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-osx"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: MCP_OSX_MODE (full (default) or compact (search_actions + run_action, ~1.2k tokens)), MCP_OSX_APPS (Comma-separated app groups to expose, e.g. system,safari,spotify), MCP_OSX_HOME (Data directory for config and workflows (default ~/.mcp-osx)).

Alternatives to macOS (osascript)

same job, measured the same way

weave

by grunion-ai

Connected tables, relations, workflows and markdown documents in one SQLite file, over MCP.

local only

Sitalk

by david-glitc

Find people with real experience. Bring their approved workflows and decisions into your agent.

answering

RoutineKit

by sjh9714

Capture tool workflows, save typed tools, and replay with human approval. Includes an MCP Apps UI.

201 installs/wk local only

ControlKeel

by aryaminus

Governed MCP workflows with policy validation, findings tracking, and review gates.

81 installs/wk local only

Mobilerun

by droidrun

Let AI agents control Android and iOS devices on Mobilerun Cloud: screen, input, apps, workflows.

answering

Cloudgate Workflow

by cloudgate

Build and manage Cloudgate workflow-APIs: controllers, actions, workflow graphs, and databases.

answering

Ephemeral

by ephemer

Run AI agent tasks in isolated sandboxes with a cost cap, saved workflows and scoped connections.

19 tools answering

EventWave

by jgaethle10

Event discovery and promotion workflows with human-controlled publishing and commerce.

6 tools answering

macOS (osascript) — questions

Answers built from our own checks of this server.

Why is there no uptime for macOS (osascript)?

macOS (osascript) runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package mcp-osx.

How do I connect macOS (osascript)?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls mcp-osx straight from npm; nothing to host, nothing to sign up for.

Is macOS (osascript) open source?

Yes — it is published under the MIT licence, written in TypeScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.