Shortcuts

shortcuts-mcp-server

Apple Shortcuts の機能にアクセスできる Model Context Protocol（MCP）サーバーです。このサーバーを使うと、AI アシスタントが MCP インターフェイスを通じてショートカットを一覧表示、確認、実行できます。

Cursor、Claude Desktop など、MCP 対応アプリケーションと互換性があります。

はじめに

前提条件

• macOS 14.5 以降
• Xcode 26.0 以降（Swift 6.2）
• mise

mise を使ったセットアップ

mise をインストールするには：

brew install mise

mise の詳細については、公式ドキュメントをご覧ください。

クイックインストール

手動インストール

以下のサーバーを使用して、MCP 設定を更新します。

{
  "mcpServers": {
    "shortcuts-mcp-server": {
      "command": "mise",
      "args": [
        "x",
        "ubi:artemnovichkov/shortcuts-mcp-server@latest",
        "--",
        "shortcuts-mcp-server"
      ]
    }
  }
}

Xcode 27 エージェントプラグイン

リポジトリのルートには、Xcode 27 がインポートできる Claude Code 形式のエージェントプラグインがあります。

.claude-plugin/
├── plugin.json
└── icon.svg

plugin.json には、カスタムツールアイコンとタイトルを設定した _meta と、MCP サーバーが定義されています。

Xcode で Settings → Intelligence → Plug-ins → Add Plug-in… を選択し、クローンしたリポジトリのディレクトリを指定します。

使い方

LLM にショートカットの実行、追加済みショートカットの一覧表示、または Shortcuts アプリでのショートカットの表示を頼むだけです。

MCP クライアントがプロンプトとリソースに対応している場合は、こちらも確認できます。

ツール

• run - ショートカットを実行します。
  • name - 実行するショートカットの名前（文字列、必須）
• list - ショートカットを一覧表示します。
  • show-identifiers - ショートカットの識別子を表示するかどうか（ブール値、任意）
• view - Shortcuts アプリでショートカットを表示します。
  • name - 表示するショートカットの名前（文字列、必須）

リソース

• list - ショートカットを一覧表示します。

プロンプト

• run - ショートカットを実行します。
  • name - 実行するショートカットの名前（文字列、必須）
• list - ショートカットを一覧表示します。
  • show-identifiers - ショートカットの識別子を表示するかどうか（ブール値、任意）
• view - Shortcuts アプリでショートカットを表示します。
  • name - 表示するショートカットの名前（文字列、必須）

参考資料

• コマンドラインからショートカットを実行する
• ショートカットに関する役立つリンク集
• Shortcuts ライブラリ
• Shortcuts ディレクトリ