Skip to main content
Glama
Kalypsokichu-code

Apple Shortcuts MCP Server

by Kalypsokichu-code
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Apple Shortcuts MCP Server

MCP server for generating and managing Apple Shortcuts (.shortcut files).

Local Setup

npm install
npm run build
npm start        # stdio mode
npm run start:http  # http mode (port 3000)

Add to ~/.claude/settings.json:

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

Remote Deployment (Docker)

docker build -t apple-shortcuts-mcp .
docker run -p 3000:3000 apple-shortcuts-mcp

Endpoint: POST /mcp Health check: GET /health

Tools

  • shortcuts_list_categories - List action categories

  • shortcuts_search_actions - Search for actions

  • shortcuts_get_action - Get action details

  • shortcuts_generate - Generate .shortcut file

  • shortcuts_analyze - Analyze shortcut complexity

  • shortcuts_validate - Validate shortcut structure

  • shortcuts_create_block - Create control flow blocks

  • shortcuts_create_action - Create common actions

  • shortcuts_list_icons - List icon options

Quick Example

{
  "name": "Hello World",
  "actions": [
    { "identifier": "gettext", "parameters": { "WFTextActionText": "Hello!" } },
    { "identifier": "showresult" }
  ]
}

Save the output as .shortcut and open on iOS/macOS.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors