Dominic-DK

Mac Shortcuts MCP — AI skill for Claude Code

AI community

Let any AI agent read your Mac — Calendar, Reminders, Notes, Contacts, Clipboard, Location, Weather — through Apple Shortcuts.

How to install Mac Shortcuts MCP

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Dominic-DK/mac-shortcuts-mcp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Mac Shortcuts MCP does

Let any AI agent read your Mac — Calendar, Reminders, Notes, Contacts, Clipboard, Location, Weather — through Apple Shortcuts. Read-only, local, no account. Includes a harvested catalog of 539 Shortcuts actions and their parameter keys.

Alternatives in AI

Manifest — Real-time cost observability for OpenClaw agents — track tokens, costs, messages, and model usage 4.1k ★
Mac Code — mac code — Claude Code, but it runs on your Mac for free 905 ★
Agentboard — Web GUI for tmux optimized for AI agent TUIs, with support for iOS safari and mac w/ keyboard shortcuts 410 ★

README

mac-shortcuts-mcp

**Let any AI agent read your Mac.** Calendar, Reminders, Notes, Contacts, Clipboard, Location, Weather, now playing — through Apple Shortcuts. Read-only, local, no account, no server.

Works with Claude Code, Claude Desktop, Cursor, Codex, or any MCP client.

npx -y mac-shortcuts-mcp setup      # install the read recipes (once)

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

Then ask your agent: *"What's on my calendar this week?"* · *"Find the note about the lease."* · *"What's Jane's number?"*

Why this exists

Your agent cannot read Apple's first-party apps. It has no permission to, and there is no API. **Shortcuts can.** This server hands the job to `Shortcuts.app`, which does have those permissions, and gives you back the text.

That is the whole trick. Nothing here is clever — it is just wired up.

What it can do

Tool	Reads
`mac_calendar`	Events in the next N days
`mac_reminders`	Reminders, optionally one list
`mac_notes`	Notes matching a search, with body text
`mac_contacts`	Contacts by name
`mac_clipboard`	Current clipboard
`mac_location`	Address and coordinates
`mac_weather`	Weather where this Mac is
`mac_device`	Machine name and battery
`mac_now_playing`	Currently playing track
`mac_shortcuts_list`	Every shortcut on this Mac
`mac_run_shortcut`	Run a shortcut you made, by name
`mac_action_catalog`	Search the Shortcuts action catalog — see below
`mac_setup` / `mac_status`	Install the read recipes, check what's ready

**The bundled recipes are read-only.** `mac_run_shortcut` can run any installed Shortcut, including one that writes data or sends messages. Its description asks the agent to check with you when the behavior is unknown; this is not an enforced read-only sandbox.

Everything read from your Mac comes back tagged as *data, not instructions*, so a not