Mac Shortcuts — read your Mac from any agent MCP Server

by dominic-dk Your server? Claim it

local only

Mac Shortcuts — read your Mac from any agent runs on your own machine — the client starts it, so there is no endpoint to ping. 37 installs a week from npm. Last commit 21 Sep 2026.

Read your Mac's Calendar, Reminders, Notes, Contacts and more via Shortcuts. Read-only, local.

Installs per day peak 242 · avg 18 · -81% w/w

a month agotoday

Installs / week

npm · mac-shortcuts-mcp

Stars

0 open issues

21 Sep 2026

Last commit

3 releases in 90 days

MIT

License

TypeScript

What the code does

We read the source, 3 d ago · rules 995398eba69f

Evidence

Things with no honest explanation: a promise that contradicts the code, code that runs at install time while hiding what it does, data leaving the machine.

Claims read-only, but the code runs commands src/install.ts:33, src/shortcuts.ts:26

  return new Promise(res => execFile(cmd, args, { timeout: timeoutMs }, (err, _o, stderr) =>

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command src/install.ts:33, src/shortcuts.ts:26

  return new Promise(res => execFile(cmd, args, { timeout: timeoutMs }, (err, _o, stderr) =>

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

We found things in this code

Code changes quietly between releases, and nobody reads the diff of a dependency. We do, on every release — watch Mac Shortcuts — read your Mac from any agent and you get told the day something new turns up.

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 mac-shortcuts-mcp -- npx -y mac-shortcuts-mcp

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

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

~/.codex/config.toml

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

.cursor/mcp.json

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

.vscode/mcp.json

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

Alternatives to Mac Shortcuts — read your Mac from any agent

same job, measured the same way

Intents MCP

by vladuzh

Your Mac's App Intents (Reminders, Calendar, Notes…) as MCP tools via Shortcuts. Public APIs only.

local only

Homeport

by capitalx

Apple Calendar, Reminders, Contacts, Notes, Messages and Shortcuts for AI, over Tailscale

local only

Cloudsuite

by cloudcorprecords

Nextcloud from your agent: notes, calendars, contacts, and files over DAV and the Notes API.

284 installs/wk local only

Notesbridge

by isaiahdupree

Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.

answering

iCloud

by epinethrone

iCloud Mail, Calendar, Contacts, Reminders, Notes and Drive. Approval-first, self-hosted or local.

217 installs/wk local only

iCloud MCP

by mrgo2

Apple Mail, Calendar, Contacts, Reminders, Notes, Messages and Safari via AppleScript or iCloud

2 143 installs/wk local only

Macuse

by macuse-app

MCP server for Mac — control Calendar, Mail, Notes, Reminders, and any Mac app, fully on-device.

local only

Fruit Forwarder MCP

by pdfowler

Scoped local MCP access to Apple Reminders and read-only Calendar data via macOS EventKit.

local only

Mac Shortcuts — read your Mac from any agent — questions

Answers built from our own checks of this server.

Why is there no uptime for Mac Shortcuts — read your Mac from any agent?

Mac Shortcuts — read your Mac from any agent 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 mac-shortcuts-mcp was installed 37 times last week.

How do I connect Mac Shortcuts — read your Mac from any agent?

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 mac-shortcuts-mcp straight from npm; nothing to host, nothing to sign up for.

How many people use Mac Shortcuts — read your Mac from any agent?

The npm package mac-shortcuts-mcp was installed 37 times in the last week. Week over week that is -81%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Mac Shortcuts — read your Mac from any agent open source?

Yes — it is published under the MIT licence, written in TypeScript and 15 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.