plugin_invoke
Invoke an installed Omni Automation plug-in in OmniFocus by its bundle identifier, with an optional argument.
Instructions
Invoke a named Omni Automation plug-in action in OmniFocus. Use this when you need to run a specific installed plug-in — not for built-in OmniFocus operations. Do NOT use to run arbitrary JavaScript; for raw scripting use run_omnijs_script (requires opt-in env var). identifier is the plug-in's bundle ID (e.g. "com.example.my-plugin"). arg is an optional JSON-serialisable value passed to the plug-in action as Action.args[0]. Returns { result } where result is the plug-in's return value (arbitrary JSON). Throws NotFound if the plug-in is not installed. Side effects: plug-in may mutate OmniFocus data; call sync_trigger if you need changes on other devices. Example: plugin_invoke({ identifier: "com.example.my-plugin" }) Example: plugin_invoke({ identifier: "com.example.my-plugin", arg: { mode: "export" } })
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| arg | No | Optional JSON-serialisable argument forwarded to the plug-in action as Action.args[0]. Defaults to null. | |
| identifier | Yes | Bundle identifier of the Omni Automation plug-in to invoke (e.g. "com.example.my-plugin"). |