Give AI agents read/write access to your Mac — Calendar, Reminders, Notes, Mail, iMessage, Music, Podcasts, Safari tabs, Shortcuts, camera, and system health. 40 MCP tools, runs locally over stdio, MIT licensed. No cloud, no API keys, no data leaving your machine.

npm: @surendranb/macos-companion-mcp
Website: macos-mcp.builditwithai.xyz
Source: github.com/surendranb/macos-mcp

The Challenge

Desktop automation is fragmented — AppleScript for Calendar, private APIs for Notes, local databases for Podcasts. No unified interface. Agents can't "check my calendar for conflicts" or "pull the transcript of that episode" without brittle one-off scripts.

The Solution

One MCP surface, 40 tools across 8 domains:

Calendar & Reminders — list calendars, get events by range, create events, reminders CRUD.
Mail & iMessage — read unread mail, send email, send texts.
Notes — list, read, create, append.
Music — playback state, play/pause/skip, volume, playlists.
Podcasts — search episodes by date, open, play, fetch full transcripts locally.
System — battery health, disk, storage scans, processes, startup items, health audit, cleanup.
Utilities — open URLs, Safari tabs, run any Siri Shortcut.
Sensing — camera snapshots, ambient noise, audio capture.

Install

npm install -g @surendranb/macos-companion-mcp

Add to any MCP client (Claude Desktop, Claude Code, Cursor, Gemini CLI, OpenCode):

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

The podcast transcript flow — search → open → play → fetch — is verified end-to-end and covered in the README.

Learning AI throughbuilding & sharing.

Learning AI through
building & sharing.