MacOS Shortcuts 라이브러리에 LLM을 연결하는 TypeScript MCP 서버. 파일 선택기, 대화 상자 및 MicrosoftScript 통합을 통해 작업을 진행하면서 CLI는 발견 및 관리 기능을 처리합니다.

왜 이 존재

AI 지원으로 기존 자동화 워크플로우를 통합하고 싶습니다. 수동으로 LLM 외부를 트리거하고 결과를 다시 복사하는 것보다,이 서버는 더 나은 자동화를위한 AI 대화 내에서 바로 가기를 실행합니다.

당신이 얻는 것

-Purpose Annotations: 당신이 그들을 사용하는 것과 같이 무슨 단축을 기록, 세션을 통하여 발견할 수 있는 의도

• Smart Discovery: 그들이 행하지 않는 것에 의해 단축키를 찾아라.
• Case-Insensitive Names: 패스 단축키 이름 as-is; 해결 자동으로 케이싱 핸들
• Interactive Support: File Pickers, 대화 상자, 그리고 AppleScript 실행을 통해 정상적으로 작동
• ** 하이브리드 통합 **: AppleScript for compatibility + 발견 및 관리를위한 CLI
• Permission Handling: 위치 서비스, 시스템 통합은 적절한 권한 상황에 따라 작동합니다

Shortcuts MCP

A TypeScript MCP server that connects LLMs to your macOS Shortcuts library. Interactive workflows with file pickers, dialogs, and prompts work through AppleScript integration, while CLI handles discovery and management.

Why This Exists

I wanted to integrate my existing automation workflows with AI assistance. Rather than manually triggering shortcuts outside of my LLM and then copying results back, this server lets me run shortcuts directly within AI conversations for better automation.

What You Get

• Purpose Annotations: Record what shortcuts do as you use them, building discoverable intent across sessions
• Smart Discovery: Browse shortcuts by what they do, not just their name — intent matching without prompting
• Case-Insensitive Names: Pass shortcut names as-is; resolution handles casing automatically
• Interactive Support: File pickers, dialogs, and prompts work normally through AppleScript execution
• Hybrid Integration: AppleScript for compatibility + CLI for discovery and management
• Permission Handling: Location services, system integrations work with proper permission context
• All Shortcut Types: Interactive workflows and automation both work reliably
• Reliable Execution: No hanging on permission requests or interactive elements
• Local Usage Tracking: Execution history and preferences stored only on your computer
• Usage Analytics: Automatic pattern analysis via MCP sampling (when supported)

Installation

Option 1: MCP Bundle (.mcpb) - Recommended

1. Download the latest .mcpb file from Releases
2. Double-click the .mcpb file or drag it onto Claude Desktop
3. Click “Install” in the Claude Desktop UI
4. Restart Claude Desktop

Option 2: Manual Installation

Clone and build locally for development:

git clone https://github.com/foxtrottwist/shortcuts-mcp.git
cd shortcuts-mcp
pnpm install
pnpm build

Add to your MCP client configuration. For Claude Desktop:

{
  "mcpServers": {
    "shortcuts-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/shortcuts-mcp/dist/server.js"]
    }
  }
}

Tested MCP Clients

This server has been tested with the following MCP clients:

• Claude Desktop
• LM Studio - Tested with models like gpt-oss and qwen3-1.7b (manual installation only)

How to Use It

Interactive Workflows

Run my "Photo Organizer" shortcut

File pickers and dialogs appear normally for user interaction. All shortcut types work including location-based and permission-requiring workflows.

Finding the Right Shortcut

What shortcuts do I have for file processing?
What shortcuts have I used this week?
Which of my shortcuts work best for photo editing?