Apple Shortcuts

io.github.JonathanRReed由 GitHub 帳號 JonathanRReed 發布v1.1.6更新於 Nov 7, 2026

List, inspect, and run Apple Shortcuts on macOS.

已驗證STDIO僅桌面效率與工作流開發者工具

概覽

AI 產生的概覽

讓 macOS 上的助理列出、檢視並執行既有的 Apple 捷徑，支援結構化輸入與輸出。

可以做什麼
  • 列出捷徑與檔案夾，並開啟某個捷徑讀取其中介資料
  • 依名稱或識別碼執行捷徑，可帶入輸入與輸出參數
  • 檢查服務健康狀態、設定與 macOS 執行需求，並重新整理捷徑目錄
  • 以關鍵字搜尋與完整工具結構查詢來探索此伺服器自身的工具
  • 為僅支援工具的用戶端提供備用提示呈現
適用情境
適合讓代理程式觸發你已在「捷徑」App 中建立好的捷徑，達成不需 shell 編排的本機自動化，或作為範圍較小、取代一體式 Apple 自動化伺服器的選擇。
執行需求
僅在 macOS 本機執行，以 stdio 程序方式透過 uvx 從 PyPI 套件 apple-shortcuts-mcp 啟動（亦可使用 Claude Desktop 擴充套件）。需要系統內建的 shortcuts 命令列工具；從複製的儲存庫執行時另需 Python 3.11 以上。輸出資料夾由 APPLE_SHORTCUTS_MCP_ALLOWED_ROOTS 設定，行為受 APPLE_SHORTCUTS_MCP_SAFETY_MODE 控制。
安裝前請注意
執行捷徑會執行其中包含的所有動作，可能變更檔案、傳送資料或呼叫其他 App；README 範例設定把 APPLE_SHORTCUTS_MCP_SAFETY_MODE 設為 full_access，也就是限制最少的等級。輸出路徑雖被限制在允許的資料夾內，但捷徑本身不受此伺服器沙箱限制。執行前應先確認要跑的是哪一個捷徑。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Apple Shortcuts，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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:

bash
uvx apple-shortcuts-mcp

No clone, no venv management.

From a clone
bash
git clone https://github.com/JonathanRReed/Apple-MCPs.gitcd Apple-MCPsuv 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
json
{  "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
bash
claude mcp add --transport stdio --scope user apple-shortcuts -- uvx apple-shortcuts-mcp

--scope user makes the server available in every project. To share it with one repository through its .mcp.json instead, use --scope project.

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.

Output Folders

shortcuts_run_shortcut writes output_path only inside the allowed folders and returns PATH_NOT_ALLOWED for any other path. Set APPLE_SHORTCUTS_MCP_ALLOWED_ROOTS to a comma-separated list of folders (~ means your home folder), or "Folders Shortcuts may write to" in the Claude Desktop extension settings. Without it, Shortcuts uses APPLE_FILES_MCP_ALLOWED_ROOTS, then the same defaults as Files: Desktop, Documents, Downloads and iCloud Drive, where they exist.

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

來源：AppleShortcuts-MCP/README.md，提交 013b3f6

工具

11

shortcuts_health

Shortcuts Health

Report the active Apple Shortcuts MCP configuration.

無需輸入參數。

shortcuts_permission_guide

Shortcuts Permission Guide

Explain the runtime requirements for Apple Shortcuts on macOS.

無需輸入參數。

shortcuts_refresh_state

Shortcuts Refresh State

Refresh Shortcuts resources and notify the client that the shortcut catalog may have changed.

無需輸入參數。

shortcuts_list_shortcuts

List Shortcuts

List Apple Shortcuts, optionally restricted to one folder.

輸入參數folder_name

shortcuts_list_folders

List Shortcut Folders

List Apple Shortcuts folders.

無需輸入參數。

shortcuts_view_shortcut

View Shortcut

Open a shortcut in the Shortcuts app by name or identifier and return its metadata.

輸入參數shortcut_name_or_identifier必填

shortcuts_run_shortcut

Run Shortcut

Run a shortcut by name or identifier with optional input and output arguments.

輸入參數input_textinput_pathsoutput_pathoutput_typeshortcut_name_or_identifier必填

shortcuts_list_prompts

Shortcuts List Prompts

Fallback prompt discovery tool for tool-only MCP clients.

無需輸入參數。

shortcuts_get_prompt

Shortcuts Get Prompt

Fallback prompt rendering tool for tool-only MCP clients.

輸入參數name必填arguments_json

search_tools

Search Tools

Search this server's tool catalog by keyword, alias, or domain tag.

輸入參數modelimitquery必填domain_tags

get_tool_info

Get Tool Info

Load the full schema, examples, and metadata for one tool from this server.

輸入參數name必填include_schemainclude_examples

版本歷史

8
  1. v1.1.6最新Nov 6, 2026
  2. v1.1.4Oct 29, 2026
  3. v1.1.3Oct 22, 2026
  4. v1.1.2Oct 14, 2026
  5. v1.1.1Oct 13, 2026
  6. v1.1.0Oct 10, 2026
  7. v1.0.5Sep 26, 2026
  8. v1.0.4Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分