v1.0.0

macOS Companion MCP

The Local Bridge Between AI Agents and the macOS Substrate.

You don't need another generic electron wrapper. You need raw, direct access to the native data structures already running on your machine. Hooks your agents directly into native macOS services, media, and system administration utilities.

System Health

Deep dive into thermal pressure, cycle counts, memory swaps, and local Time Machine snapshots.

Native Apps

Headless access to Reminders, Notes, and Calendar without UI bloat.

Media Intel

Directly reads SQLite databases to find exact podcast listening playback heads.

Admin Control

Triggers native Siri Shortcuts and clears DerivedData or user caches safely.

Quick Setup

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "macos-companion-mcp": {
      "command": "npx",
      "args": ["-y", "@surendranb/macos-mcp"]
    }
  }
}

Add this MCP server in your Cursor settings:

npx -y @surendranb/macos-mcp

Run via npx instantly (Requires Node v18+):

npx @surendranb/macos-mcp