🆕Using Custom Toolhouse Nodes in n8n

This guide walks you through the installation and running of custom Toolhouse nodes in n8n, enabling you to call Toolhouse agents within n8n workflows.

This guide assumes you have the latest versions of Docker and Node.js installed in your environment.

Installation

First, set up a new folder to store your n8n instance.

Run these commands in the terminal:

git clone <https://github.com/toolhouseai/toolhouse-n8n.git>

Change the directory:

cd toolhouse-n8n

Then run:

npm install

Note: Make sure you have Node.js installed and updated to at least v16.

npm run build

After that, make sure you have Docker open on your desktop and run:

docker compose up

A successful run will look like this:

You will now be able to access n8n at http://localhost:5678.

If the run fails, ensure Docker is open and running the correct container.

Your Docker Desktop should look like this:

Using n8n

Your landing page should look like this:

Create Credentials

To use Toolhouse agents in your workflows, you'll need to connect your Toolhouse account.

From the sidebar, select Credentials > Add Credential.

You will need a Toolhouse API key. To get your API key, go to Toolhouse API Keys and either:

• Copy an existing key, or

• Click Generate New Key

Paste your API key into the appropriate field in the n8n node configuration, and then click Save to apply the changes.

You're now ready to use Toolhouse Nodes in your workflows!

Starting a Toolhouse Agent Conversation on Workflow Execution

Here is an example workflow using Custom Toolhouse Nodes.

Add a Trigger Node

Start your workflow with a trigger node. In this example, use the Manual Trigger node, which enables you to launch the workflow by clicking Execute Workflow.

Add the Toolhouse Node

Add the Toolhouse Agent Node to your flow.

You can use this node to:

• Start a new conversation, or

• Continue an existing one by providing the agentId and the previous agentRunId.

This allows your workflow to pick up where a previous interaction left off.

After selecting Start Conversation in the Toolhouse Node, your flow should resemble the following structure:

To choose an agent, open the Toolhouse Node and use the dropdown menu to select the agent you want to use in this workflow.

If no agents are found:

1. Reopen your credentials

2. Confirm your Toolhouse API key is valid

This is where all of your Toolhouse agents will appear.

If you haven’t created any agents yet, please follow our Quickstart Guide to get started quickly and learn how to set up your first agent.

Executing the Flow

When you click “Execute Workflow”, this flow will initiate a conversation with your Toolhouse agent.

Next steps

You're All Set! Your n8n instance is now fully connected to Toolhouse agents.

You can go ahead and build your own workflows with Toolhouse and n8n.

Happy Building!

Need help? Visit Toolhouse Support or ask in our Community Discord.