Apple Shortcuts MCP

MCP server for Apple Shortcuts on macOS.

Provides access to shortcuts for discovery, inspection, and execution. Run shortcuts with structured input and output handling.

When to use

  • Triggering existing Apple Shortcuts from agents
  • Local automation without shell orchestration
  • Smaller scope than the all-in-one server

What It Does

  • List shortcuts and folders
  • Inspect shortcut details
  • Run shortcuts with input/output handling
  • Tool discovery helpers search_tools and get_tool_info for context-constrained clients
  • Shortcut resources and execution prompts
  • Health and state checks: shortcuts_health, shortcuts_permission_guide, shortcuts_refresh_state

Install On This Mac

Quick start (uvx, from PyPI)

With uv installed:

uvx apple-shortcuts-mcp

No clone, no venv management.

From a clone 
git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv sync --all-packages

This builds one workspace environment with every server's entry point in .venv/bin (for example .venv/bin/apple-shortcuts-mcp). You can also point an MCP client at AppleShortcuts-MCP/start.sh, which prefers uv run and falls back to a plain venv bootstrap (Python 3.11+ required).

Install In AI Agents

Generic MCP client config 
{
  "mcpServers": {
    "apple-shortcuts": {
      "command": "uvx",
      "args": ["apple-shortcuts-mcp"],
      "env": {
        "APPLE_SHORTCUTS_MCP_SAFETY_MODE": "full_access"
      }
    }
  }
}

Running from a clone instead? Use /path/to/Apple-MCPs/AppleShortcuts-MCP/start.sh as the command with empty args.

Claude Code example 
claude mcp add --transport stdio --scope project apple-shortcuts -- uvx apple-shortcuts-mcp

Transport

stdio is the default and recommended transport. Set APPLE_SHORTCUTS_MCP_TRANSPORT=streamable-http (with optional APPLE_SHORTCUTS_MCP_HOST and APPLE_SHORTCUTS_MCP_PORT) to serve Streamable HTTP instead.

macOS Requirements

  • the built-in shortcuts CLI must be available

Launch Checklist

  • Add uvx apple-shortcuts-mcp (or a clone's AppleShortcuts-MCP/start.sh) to your MCP client
  • Reload or reconnect the client so the Shortcuts tool surface is loaded into context
  • Call shortcuts_health first
  • If the CLI is unavailable, call shortcuts_permission_guide
  • After changing the Shortcuts catalog, call shortcuts_refresh_state

Prompting Notes

  • tools/list returns the full Shortcuts tool surface. Context-constrained clients can use search_tools first, then get_tool_info for the Shortcuts tool they need.
  • If the user asks for a shortcut vaguely, list available shortcuts first.
  • Run a shortcut only after confirming which shortcut to run.

Related

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for JonathanRReed from gravatar.com JonathanRReed

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev

Tags

mcp model-context-protocol macos apple ai-agent automation

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

apple_shortcuts_mcp-1.0.1.tar.gz (14.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

apple_shortcuts_mcp-1.0.1-py3-none-any.whl (12.2 kB view details)

Uploaded Python 3

File details

Details for the file apple_shortcuts_mcp-1.0.1.tar.gz.

File metadata

  • Download URL: apple_shortcuts_mcp-1.0.1.tar.gz
  • Upload date:
  • Size: 14.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for apple_shortcuts_mcp-1.0.1.tar.gz
Algorithm Hash digest
SHA256 4abe837a9d64976cd4139841531d0a463115b43cbf996b814c98201e0a019c8d
MD5 8cf007253ddd854e6382801e41c58b21
BLAKE2b-256 48c42dab70fab2cd8018d78731fec03f90ecdeeaafcd542efe2efc1124ea00fa

See more details on using hashes here.

Provenance

The following attestation bundles were made for apple_shortcuts_mcp-1.0.1.tar.gz:

Publisher: release.yml on JonathanRReed/Apple-MCPs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file apple_shortcuts_mcp-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for apple_shortcuts_mcp-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 64d7ff618d6c49997ea644cc5eda119e2b5f4423f14f0c4f80c9a0054dda77f6
MD5 3e67aa435a1d1f3555d9cb9cde37c42e
BLAKE2b-256 35cd180499521c0099c70b2a036063817a3e0256c1ceeecbe94c9bffbc877e30

See more details on using hashes here.

Provenance

The following attestation bundles were made for apple_shortcuts_mcp-1.0.1-py3-none-any.whl:

Publisher: release.yml on JonathanRReed/Apple-MCPs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page