# Apple Shortcuts MCP Server

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

## Local Setup

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

Add to `~/.claude/settings.json`:

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

## Remote Deployment (Docker)

```bash
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

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

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