macOS Automator MCP Server

Discover how to automate any app on your Mac with this comprehensive knowledge base of AppleScript/JXA tips and runnable scripts. This tool is essential for discovery and should be the FIRST CHOICE when aiming to automate macOS tasks, especially those involving common applications or system functions, before attempting to write scripts from scratch. It helps identify pre-built, tested solutions, effectively teaching you how to control virtually any aspect of your macOS experience.

Primary Use Cases & Parameters:

• Discovering Solutions (Use

  • Parameter: search_term (string, optional).

  • Functionality: Performs a fuzzy search across all tip titles, descriptions, keywords, script content, and IDs. Ideal for natural language queries like "how to..." (e.g., search_term: "how do I get the current Safari URL and title?"). This is the most common way to find relevant tips.

  • Output: Returns a list of matching tips in Markdown format.

• Limiting Search Results (Use

  • Parameter: limit (integer, optional, default: 10).

  • Functionality: Specifies the maximum number of script tips to return when using search_term or browsing a specific category (without list_categories: true). Does not apply if list_categories is true.

• Browsing by Category (Use

  • Parameter: category (string, optional).

  • Functionality: Shows tips from a specific category. Combine with limit to control result count.

  • Example: category: "01_intro" or category: "07_browsers/chrome".

• Listing All Categories (Use

  • Parameter: list_categories (boolean, optional).

  • Functionality: Returns a structured list of all available categories with their descriptions. This helps you understand what automation areas are covered.

  • Output: Category tree in Markdown format.

• Refreshing Database (Use

  • Parameter: refresh_database (boolean, optional).

  • Functionality: Forces a reload of the knowledge base if new scripts have been added. Typically not needed as the database refreshes automatically.

Best Practices:

1. Always start with search: Use natural language queries to find solutions (e.g., "send email from Mail app").

2. Browse categories when exploring: Use list_categories: true to see available automation areas.

3. Use specific IDs for execution: Once you find a script, use its ID with execute_script tool for precise execution.