BetterTouchTool MCP Server

Use this tool to explore and understand the current BTT configuration.
You can filter by trigger type, parent folder, specific app, or get all triggers.

Args:
    params: Filter parameters including trigger_type, trigger_id, app_bundle_identifier, etc.

Returns:
    List of triggers in markdown or JSON format based on response_format setting.

Use this to get detailed information about a single trigger, including
all its configuration and assigned actions.

Args:
    params: Contains the UUID of the trigger to retrieve.

Returns:
    Trigger configuration in markdown or JSON format.

Named triggers are triggers configured in the 'Other' tab that can be
called by name from scripts or other actions.

Returns:
    List of named triggers with their names and UUIDs.

Named triggers are configured in BTT's 'Other' tab and can perform
any sequence of actions.

Args:
    params: Contains the trigger_name and whether to wait for completion.

Returns:
    Result of the trigger execution (if wait_for_reply is True).

You can get the JSON for an action by right-clicking a configured
trigger in BTT and selecting 'Copy JSON'.

Args:
    params: Contains the action JSON definition.

Returns:
    Result of the action execution.

Args:
    params: Contains the UUID of the trigger to execute.

Returns:
    Result of the execution.

The trigger definition should be in JSON format. You can get
the format by copying an existing trigger's JSON in BTT.

Args:
    params: Contains the trigger JSON definition and optional parent UUID.

Returns:
    Confirmation of trigger creation.

Provide the UUID of the trigger and a JSON object with the
properties to update.

Args:
    params: Contains UUID and JSON with properties to update.

Returns:
    Confirmation of update.

WARNING: This permanently removes the trigger. Make sure you have
the correct UUID before deleting.

Args:
    params: Contains the UUID of the trigger to delete.

Returns:
    Confirmation of deletion.

BTT has many built-in variables (like BTTActiveAppBundleIdentifier)
and supports user-defined variables.

Args:
    params: Variable name and type (string or number).

Returns:
    Current value of the variable.

Variables can be persistent (survive BTT restart) or runtime-only.

Args:
    params: Variable name, value, type, and persistence setting.

Returns:
    Confirmation of variable being set.

This allows temporary updates to widget appearance without changing
the underlying configuration.

Args:
    params: Widget UUID, type, and display properties to update.

Returns:
    Confirmation of widget update.

Use this to force a widget to update its display by running
its assigned scripts again.

Args:
    params: UUID of the widget to refresh.

Returns:
    Confirmation of refresh.

Can retrieve content in various formats including plain text, HTML,
images (as base64), and more.

Args:
    params: Format to retrieve and whether to return as base64.

Returns:
    Clipboard content.

Can set content in various formats including plain text and HTML.

Args:
    params: Content to set and format.

Returns:
    Confirmation of clipboard being set.

Useful for backing up configurations or sharing presets.

Args:
    params: Preset name and export options.

Returns:
    Path to exported preset file.

Args:
    params: Path to the preset file.

Returns:
    Confirmation of import.

Returns information about the preset's status, UUID, and visibility.

Args:
    params: Name of the preset to query.

Returns:
    Preset details in markdown or JSON format.

Args:
    params: Notification title, subtitle, sound, and optional image.

Returns:
    Confirmation of notification being displayed.

Opens BTT and navigates to the specified element for editing.

Args:
    params: UUID of the element to reveal.

Returns:
    Confirmation.