Gitpulse
Merged
Size
XL
Change Breakdown
Feature75%
Refactor15%
Maintenance10%
#28065feat: Add ToolFromNode implementation

Single n8n nodes now run as agent tools

Single n8n nodes now run as agent tools
YE
yehorkardash
·Apr 10, 2026

Developers can now expose individual n8n nodes as callable tools for AI agents, without building complete workflows. The new ToolFromNode class lets agents execute lightweight, single-node operations on demand.

Agents built with the n8n SDK can now call individual nodes directly, without the overhead of a full workflow. The new ToolFromNode class lets developers wrap a single n8n node — complete with parameters and credentials — into a tool the agent can invoke during conversation.

This works through ephemeral execution: each tool call spins up an in-memory Manual Trigger connected to the target node, runs it, and tears it down immediately. No workflow gets saved to the database, no execution appears in history, and no production queue is involved. The caller gets the result synchronously.

The capability complements the existing WorkflowTool, which handles multi-step workflows. Simple operations like sending an email, fetching a record, or running a calculation no longer need a workflow scaffold — one node, one tool call.

The credential provider was also relaxed: previously only LLM provider credentials were listed, but now all credential types work with tool execution. This opens up nodes that require database, API, or custom credentials.

This is part of a larger effort to give agents granular control over n8n operations. The groundwork for fetching node definitions dynamically is noted as a future addition.

View Original GitHub Description

Summary

Adds ToolFromNode — a new tool type for SDK agents that executes a single n8n node as a callable tool, without requiring a full workflow. This complements the existing WorkflowTool (multi-step workflows) with a lightweight, single-node alternative.

New execution mode: ephemeral

A new ephemeral workflow execution mode drives the node execution:

  • PinData support — LLM input is pinned on a disposable Manual Trigger node so n8n expressions like ={{ $json.field }} resolve against it
  • Unlimited concurrency — bypasses the production queue (like manual/integrated)
  • Synchronous result — the caller awaits the result inline (needed for tool calls)
  • No statistics / insights — ephemeral workflows are filtered out of listings, execution history, and telemetry Each tool call creates a transient ManualTrigger → TargetNode workflow, executes it, and deletes it immediately via EphemeralNodeExecutor.

Important This PR does not update agent builder LLM with instructions and tools to fetch node definitions. This will be added later on

Related Linear tickets, Github issues, and Community forum posts

https://linear.app/n8n/issue/AGENT-5

Review / Merge checklist

  • PR title and summary are descriptive. (conventions) <!-- **Remember, the title automatically goes into the changelog. Use `(no-changelog)` otherwise.** -->
  • Docs updated or follow-up ticket created.
  • Tests included. <!-- A bug is not considered fixed, unless a test is added to prevent it from happening again. A feature is not complete without tests. -->
  • PR Labeled with Backport to Beta, Backport to Stable, or Backport to v1 (if the PR is an urgent fix that needs to be backported)
© 2026 · via Gitpulse