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 运行要求，并刷新快捷指令目录
  • 通过关键词搜索与完整工具结构查询来发现本服务器自身的工具
  • 为仅支持工具的客户端提供备用提示渲染
适用场景
适合让智能体触发你已在“快捷指令”应用中建好的快捷指令，实现无需 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 控制。
安装前请注意
运行快捷指令会执行其中包含的所有操作，可能改动文件、发送数据或调用其他应用；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 分