// MCP TOOL REFERENCE

KEYBOARD MAESTRO TOOLS

34 tools from the Keyboard Maestro MCP Server, categorised by risk level.

// ALL 34 KEYBOARD MAESTRO TOOLS

READ 9 tools

Read km_get_action_xml Get the XML definition of a specific action in a macro. Actions are 1-indexed. Read km_get_errors Get recent errors and failures from Keyboard Maestro Engine log. Returns errors grouped by macro with times... Read km_get_log Get raw log entries from Keyboard Maestro Engine log with optional filters. Read km_get_macro Get details about a specific macro by name or UID. Read km_get_macro_xml Get the full XML definition of a macro. Useful for understanding macro structure or creating similar macros. Read km_get_trigger_xml Get the XML definition of a specific trigger in a macro. Triggers are 1-indexed. Read km_list_actions List all actions in a macro with their index, name, and enabled status. Read km_list_macros List all macros in Keyboard Maestro with their names and UIDs. Read km_search_macros Search for macros by name (case-insensitive partial match). returns name and UID.

WRITE 18 tools

Write km_search_replace_action Search and replace text within a specific action in a macro. Useful for fixing typos or updating values. Write km_add_action Add an action to an existing macro using XML. Write km_add_calculation Add an action to set a variable to the result of a calculation (e.g., Write km_add_display_text Add an action to display text in a window. Write km_add_if_calculation Add an If-Then-Else action that checks a calculation condition (e.g., Write km_add_if_variable_contains Add an If-Then-Else action that checks if a variable contains a value. Write km_add_notification Add a notification action to a macro. Much simpler than using km_add_action with raw XML. Write km_add_pause Add a pause action to a macro. Write km_add_set_variable Add an action to set a variable to a text value. Write km_add_trigger Add a trigger to a macro using XML. Write km_clone_macro Duplicate an existing macro. Optionally provide a new name. Write km_create_macro Create a new macro with a name. Optionally include action XML to add an initial action. Write km_enable_macro Enable or disable a macro. Write km_manage_variable Manage Keyboard Maestro variables (get, set, delete). Write km_move_action Move an action to a new position index. Subsequent actions will shift down. Write km_move_macro Move a macro to a different macro group. Write km_set_action_xml Set/replace the XML of a specific action in a macro. Use km_get_action_xml first to get the current XML. Write km_set_trigger_xml Set/replace the XML of a specific trigger in a macro. Use km_get_trigger_xml first to understand the format.

DESTRUCTIVE 4 tools

Destructive km_delete_action Delete a specific action from a macro. Actions are 1-indexed. WARNING: This cannot be undone! Destructive km_delete_macro Delete a macro by name or UID. WARNING: This cannot be undone! Destructive km_delete_trigger Delete a trigger from a macro. Triggers are 1-indexed. Destructive km_manage_group Manage macro groups (create, delete, toggle, list).

EXECUTE 3 tools

Execute km_run_macro Execute a macro by name or UID. Execute km_add_execute_macro Add an action to execute another macro. Execute km_add_shell_script Add an action to execute a shell script.

// FAQ

How many tools does the Keyboard Maestro MCP server have? +

The Keyboard Maestro MCP server exposes 34 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Keyboard Maestro tools? +

Route the Keyboard Maestro server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do Keyboard Maestro tools fall into? +

Keyboard Maestro tools are categorised as Read (9), Write (18), Destructive (4), Execute (3). Each category has a recommended default policy.

Enforce policy on every Keyboard Maestro tool call.

Start from Keyboard Maestro, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →

Free to start. No card required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.