# Apple Shortcuts MCP Server
MCP server for creating, analyzing, and managing Apple Shortcuts.
## Remote (Hosted)
```json
{
"mcpServers": {
"apple-shortcuts": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://shortcuts-mcp.kalyp.so/sse", "--transport", "sse-only"]
}
}
}
```
## Local
```bash
npm install && npm run build
npm start # stdio
npm run start:http # http on port 3000
```
```json
{
"mcpServers": {
"apple-shortcuts": {
"command": "node",
"args": ["/path/to/dist/index.js"]
}
}
}
```
## Docker
```bash
docker build -t apple-shortcuts-mcp .
docker run -p 3000:3000 apple-shortcuts-mcp
```
## Tools
| Tool | Description |
|------|-------------|
| `shortcuts_list_categories` | List action categories |
| `shortcuts_search_actions` | Search actions |
| `shortcuts_get_action` | Get action details |
| `shortcuts_generate` | Generate .shortcut file |
| `shortcuts_analyze` | Analyze shortcut |
| `shortcuts_validate` | Validate shortcut |
| `shortcuts_create_block` | Create control flow blocks |
| `shortcuts_create_action` | Create common actions |
| `shortcuts_list_icons` | List icon options |
## Example
```json
{
"name": "Hello",
"actions": [
{ "identifier": "gettext", "parameters": { "WFTextActionText": "Hello!" } },
{ "identifier": "showresult" }
]
}
```
