Search Node-RED nodes
nodered_search_nodesFind Node-RED nodes by type or name across all flows and subflows, returning each match's flow, label, and disabled state without changing anything.
Instructions
Find Node-RED nodes by type and/or name across all flows and subflows.
Reads GET /flows and matches every node except tab and subflow
definitions: type and name are case-insensitive substrings, both
must match when both are given. Each hit carries its flow (or subflow)
id and label and whether it is disabled (node or flow). Changes nothing.
Use when: locating nodes of one kind, e.g. every api-call-service or
server-state-changed node, or a node by its name.
Not for: which nodes use one HA entity — use
nodered_find_entity_usage; a whole flow — use nodered_get_flow.
Returns: {"addon_slug", "rev", "matches": [{id, type, name, flow_id, flow_label, in_subflow, disabled, config?}], "count", "truncated"};
config only with include_config, plus redacted_fields then.
Errors: no_filter when neither type nor name is given (no I/O),
plus the add-on lookup errors of nodered_list_flows.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "nodered_search_nodes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Case-insensitive part of the node's name as shown in the editor. | |
| type | No | Case-insensitive part of the node type, e.g. `api-call-service`, `mqtt in`, `function`. | |
| limit | No | Maximum number of nodes returned (1-500, default 100). | |
| flow_id | No | Only nodes in this flow (tab) or subflow id; omit to search everywhere. | |
| include_config | No | True adds each node's full configuration (secrets replaced by the placeholder). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||