Skip to content

Custom n8n Workflow Tool#

The Workflow Tool node is a tool that allows an agent to run another n8n workflow and fetch its output data.

On this page, you'll find the node parameters for the Workflow Tool node, and links to more resources.

Examples and templates

For usage examples and templates to help you get started, refer to n8n's Custom n8n Workflow Tool integrations page.

Parameter resolution in sub-nodes

Sub-nodes behave differently to other nodes when processing multiple items using an expression.

Most nodes, including root nodes, take any number of items as input, process these items, and output the results. You can use expressions to refer to input items, and the node resolves the expression for each item in turn. For example, given an input of five name values, the expression {{ $json.name }} resolves to each name in turn.

In sub-nodes, the expression always resolves to the first item. For example, given an input of five name values, the expression {{ $json.name }} always resolves to the first name.

Node parameters#

Name#

Give your custom code a name. It can't contain whitespace or special characters.

Description#

Give your custom code a description. This tells the agent when to use this tool. For example:

Call this tool to get a random color. The input should be a string with comma separated names of colors to exclude.

Source#

Tell n8n which workflow to call. You can choose either:

  • Database, then enter a workflow ID.
  • Parameter, then copy in a complete workflow JSON.

Field to Return#

This must match the name of the output property in the workflow you're calling.

Workflow Values#

Set values to pass to the workflow you're calling.

These values appear in the output data of the trigger node in the workflow you call. You can access these values in expressions in the workflow. For example, if you have:

  • Workflow Values with a Name of myCustomValue
  • A workflow with an Execute Workflow Trigger node as its trigger

The expression to access the value of myCustomValue is {{ $('Execute Workflow Trigger').item.json.myCustomValue }}.

View example workflows and related content on n8n's website.

Refer to LangChain's documentation on tools for more information about tools in LangChain.

View n8n's Advanced AI documentation.