MQTT GeneralInstall

Summary

Publish an MQTT message to trigger a mouse click action on a remote device or interface, optionally waiting for and processing a response message.

Inputs

• Topic (required) — The MQTT topic to which the click action message is published, e.g., 'playwright/mouse/click'.
• QoS — The MQTT Quality of Service level for message delivery (0: at most once, 1: at least once, 2: exactly once).
• Include Input Items — Whether to include selected fields from the previous node's input items in the MQTT payload under 'inputItems'.
• Include Input Items Fields — Comma or newline-separated list of field paths from previous input items to include in the payload under 'inputItems'.
• Wait For Response — When true, the node subscribes to a specified response topic and waits for a reply before completing.
• Response Topic (required) — The MQTT topic to listen on for the response message when 'Wait For Response' is enabled. Defaults to 'RES_' plus the main topic.
• Response Timeout (ms) — Maximum time in milliseconds to wait for a response before timing out. Default is 10000 ms.
• Parse Response As JSON — Whether to parse the response payload as JSON if possible. Defaults to true.
• Target — High-level locator string for the click target (e.g., 'css=button.submit', 'id=btnClick').
• XPath — Explicit XPath locator for the click target, used if not specifying target string syntax.
• X — Absolute X coordinate in the viewport for the click. If set, overrides target selectors.
• Y — Absolute Y coordinate in the viewport for the click. If set, overrides target selectors.
• Button — Mouse button to use for the click: 'left', 'middle', or 'right'. Default is 'left'.
• Clicks — Number of click repetitions in a single action. Minimum 1, default is 1.
• Delay Between Clicks (ms) — Delay in milliseconds between repeated clicks if 'Clicks' is more than 1.

Output shape

a list of items reflecting input items annotated with MQTT action details; if 'Wait For Response' is true, includes the response data under 'mqtt.response'

If there are input items, the output corresponds to those items enriched with MQTT metadata. If no input items exist, a single output item with the MQTT details is returned. When waiting for a response, the response message is included in the output JSON under 'mqtt.response' with the raw payload and parsed form if JSON parsing is enabled. Errors during publishing or response waiting cause the node to error or output an error item if 'Continue On Fail' is enabled.

Examples

Example 1: Publish a click action to the topic 'playwright/mouse/click' to simulate a single left click on a button located by CSS selector 'button.submit'.

Topic: 'playwright/mouse/click'; Target: 'css=button.submit'; Button: 'left'; Clicks: 1; QoS: 1.

Example 2: Publish a right-click action at absolute coordinates X=520, Y=340 over MQTT topic 'device/phone_01/action' and wait for a response on 'RES_device/phone_01/action'.

Topic: 'device/phone_01/action'; X: 520; Y: 340; Button: 'right'; Wait For Response: true; Response Topic: 'RES_device/phone_01/action'; Response Timeout (ms): 10000.

Links

• n8n community nodes installation guide