Alfred MCP Server connects AI assistants directly to macOS Alfred 5. It allows AI models to search, create, modify, execute, and package Alfred workflows using natural language.
Features
List & Search Workflows: Instantly scan installed Alfred workflows by name, bundle ID, or keyword.
Deep Inspection: Read workflow configurations, node objects, script code, plist data, and included files.
MCP Server for inspecting, creating, editing, running, exporting, and deleting macOS Alfred 5 workflows.
Estrellas
19
Herramientas
—
Disponibilidad
—
Create Workflows: Generate new Alfred 5 workflows from templates (keyword_script, script_filter, hotkey_trigger, empty) complete with UUIDs, nodes, and canvas positioning.
Edit & Update: Modify metadata (name, description, bundle ID, README) and update script contents or keywords in real-time.
File Management: Create or update embedded scripts, Python modules, shell files, or config assets directly inside workflow folders.
Trigger Actions: Fire Alfred External Triggers programmatically via macOS AppleScript.
Export & Package: Package workflows into standard .alfredworkflow files for distribution.
Safe Deletion: Safely trash workflows by moving them to macOS Trash via send2trash.
Prerequisites
macOS 12.0 or later.
Alfred 5 with an active Powerpack license.
Python 3.10 or higher.
Quick Setup & Onboarding
Choose your preferred installation method:
Option A: 1-Click Automated Setup (Recommended)
Run the automated installer script to create the environment, install dependencies, and automatically register alfred-mcp into Claude Desktop, Cursor, and Antigravity IDE:
git clone https://github.com/saihgupr/alfred-mcp.git
cd alfred-mcp
./install.sh
Option B: Zero-Install Execution (uvx / pipx)
If you use uv, you can run alfred-mcp directly without cloning or managing virtual environments manually. Add the following entry to your MCP client config (e.g. claude_desktop_config.json):
List all installed Alfred workflows with optional search query filtering (matches name, bundle ID, keyword).
alfred_get_workflow
Retrieve comprehensive workflow details including metadata, node objects, script code, connections, and files.
alfred_create_workflow
Create a new Alfred 5 workflow with proper info.plist structure, objects, and canvas connections.
alfred_update_workflow_info
Update metadata settings in a workflow's info.plist (name, description, bundle ID, README, disabled state, version).
alfred_update_script_node
Update the script code or keyword of a target script node inside a workflow.
alfred_edit_file
Create or overwrite files (e.g. main.py, script.sh, config.json) inside a workflow folder.
alfred_delete_workflow
Safely delete an Alfred workflow by moving its folder to macOS Trash.
alfred_export_workflow
Package a workflow directory into an installable .alfredworkflow file in Downloads or a specified folder.
alfred_run_trigger
Trigger an Alfred workflow's External Trigger using macOS AppleScript (osascript).
Troubleshooting & Debugging
If you encounter any issues while using alfred-mcp:
1. Log Locations
Claude Desktop Logs: Check ~/Library/Logs/Claude/mcp.log and ~/Library/Logs/Claude/mcp-server-alfred.log for execution errors.
Antigravity IDE Logs: Inspect ~/.gemini/antigravity-ide/mcp_config.json and agent session logs.
Cursor Logs: Open the Output panel in Cursor and select MCP Server Log.
2. macOS Automation Permissions
alfred_run_trigger uses AppleScript (osascript) to talk to Alfred 5.
Ensure your MCP client (Antigravity IDE / Claude Desktop / Cursor / Terminal) has permission under: System Settings > Privacy & Security > Automation > [Your Client] > Alfred 5.
If your workflows are stored in a custom folder, verify that Alfred 5 preferences plist (com.runningwithcrayons.Alfred-Preferences-3.plist) points to your current sync folder.
4. Interactive MCP Inspector
Test server tools locally with the MCP Inspector tool:
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo Alfred?
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿Alfred necesita una clave de API?
Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa Alfred?
Alfred se ejecuta localmente por stdio.
¿Cuándo se comprobó Alfred por última vez?
Última comprobación: 2026-10-28. MCP Server for inspecting, creating, editing, running, exporting, and deleting macOS Alfred 5 workflows.