macOS Automator MCP Server

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "kb_script_id": {
      "description": "The ID of a knowledge base script to execute. Replaces script_content and script_path if provided.",
      "type": "string"
    },
    "script_content": {
      "description": "The content of the script to execute. Required if kb_script_id or script_path is not provided.",
      "type": "string"
    },
    "script_path": {
      "description": "The path to the script file to execute. Required if kb_script_id or script_content is not provided.",
      "type": "string"
    },
    "arguments": {
      "description": "Optional arguments to pass to the script. For AppleScript, these are passed to the main `run` handler. For JXA, these are passed to the `run` function.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "input_data": {
      "description": "Optional JSON object to provide named inputs for --MCP_INPUT placeholders in knowledge base scripts.",
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "language": {
      "description": "Specifies the scripting language. Crucial for `script_content` and `script_path` if not 'applescript'. Defaults to 'applescript'. Inferred if using `kb_script_id`.",
      "type": "string",
      "enum": [
        "applescript",
        "javascript"
      ]
    },
    "timeout_seconds": {
      "default": 60,
      "description": "The timeout for the script execution in seconds. Defaults to 60.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "output_format_mode": {
      "default": "auto",
      "description": "Controls osascript output formatting. \n'auto': (Default) Smart selection based on language (AppleScript: human_readable, JXA: direct). \n'human_readable': AppleScript -s h. \n'structured_error': AppleScript -s s. \n'structured_output_and_error': AppleScript -s ss. \n'direct': No -s flags (recommended for JXA).",
      "type": "string",
      "enum": [
        "auto",
        "human_readable",
        "structured_error",
        "structured_output_and_error",
        "direct"
      ]
    },
    "report_execution_time": {
      "default": false,
      "description": "If true, the tool will return an additional message containing the formatted script execution time. Defaults to false.",
      "type": "boolean"
    },
    "include_executed_script_in_output": {
      "default": false,
      "description": "If true, the executed script content (after substitutions) or path will be included in the output.",
      "type": "boolean"
    },
    "include_substitution_logs": {
      "default": false,
      "description": "If true, detailed logs of placeholder substitutions will be included in the output.",
      "type": "boolean"
    }
  }
}

{
  "title": "Execute Script",
  "destructiveHint": true
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "category": {
      "description": "Specific category of tips. If omitted with no `search_term`, lists all categories.",
      "type": "string"
    },
    "search_term": {
      "description": "Keyword to search within tip titles, content, keywords, or IDs.",
      "type": "string"
    },
    "list_categories": {
      "default": false,
      "description": "If true, returns only the list of available categories and their descriptions. Overrides other parameters.",
      "type": "boolean"
    },
    "refresh_database": {
      "description": "If true, forces a reload of the knowledge base before processing the request.",
      "type": "boolean"
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of results to return. Default is 10.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  }
}

{
  "title": "Get Scripting Tips",
  "readOnlyHint": true
}