# Apple Shortcuts MCP Server
A specialized Model Context Protocol server for creating, analyzing, and managing Apple Shortcuts.
---
## Remote Configuration
To use the hosted instance, add this to your MCP client configuration (e.g., `claude_desktop_config.json`).
| Field | Value |
| :--- | :--- |
| **Endpoint** | `https://shortcuts-mcp.kalyp.so/mcp` |
| **Transport** | Streamable HTTP |
### Claude Desktop Setup
```json
{
"mcpServers": {
"apple-shortcuts": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/mcp-remote",
"https://shortcuts-mcp.kalyp.so/mcp"
]
}
}
}
```
---
## Local Development
| Action | Command |
| :--- | :--- |
| Install | `npm install` |
| Build | `npm run build` |
| Start (Stdio) | `npm start` |
| Start (HTTP) | `npm run start:http` |
### Stdio Configuration
```json
{
"mcpServers": {
"apple-shortcuts": {
"command": "node",
"args": ["/path/to/project/dist/index.js"]
}
}
}
```
---
## Deployment
### Docker
```bash
docker build -t apple-shortcuts-mcp .
docker run -p 3000:3000 apple-shortcuts-mcp
```
---
## Available Tools
| Tool | Description |
| :--- | :--- |
| `shortcuts_list_categories` | Retrieve all Apple Shortcuts action categories |
| `shortcuts_search_actions` | Search for actions by name, description, or identifier |
| `shortcuts_get_action` | Detailed parameters and info for a specific action |
| `shortcuts_generate` | Produce a .shortcut file from a JSON action list |
| `shortcuts_analyze` | Evaluate shortcut complexity and logic patterns |
| `shortcuts_validate` | Check structure, UUIDs, and control flow blocks |
| `shortcuts_create_block` | Generate If, Repeat, or Menu control structures |
| `shortcuts_create_action` | Utility for creating common action schemas |
| `shortcuts_list_icons` | View available glyphs and colors for shortcut icons |
---
## Example Input
```json
{
"name": "Quick Notification",
"actions": [
{
"identifier": "is.workflow.actions.gettext",
"parameters": {
"WFTextActionText": "Processing complete"
}
},
{
"identifier": "is.workflow.actions.showresult"
}
]
}
```
