Resources · Claude connector

Claude n8n connectorWhat Claude can do in your n8n account.

The Claude n8n connector exposes 27 tools: 14 read, 13 write, 0 undocumented. Below: what Claude sees in your n8n instance, what it can run, publish or rewrite, the switch an admin must flip first, and the tool names n8n has since changed.

Verified Trustpilot reviews · AI, automation & growth agency

Overview

What changes when Claude can reach your instance

Instead of opening the editor to check why a workflow failed or to add a step, you describe the job to Claude. It searches your n8n instance, reads the workflow and its past runs, and can test, run or edit it from the conversation. n8n itself stays the place where the workflows live and run; Claude becomes a way to operate it by asking.

Find out why last night's run broke. search_executions lists recent runs with their status and timing, then get_execution opens the one that failed so Claude can walk you through what went wrong, node by node.

Build a workflow from a description. You explain the job in plain words. Claude reads the node catalogue with search_nodes and get_node_types, writes the code, checks it with validate_workflow, then saves it through create_workflow_from_code. Before anything touches a real service, test_workflow runs it on simulated data for the nodes that hold credentials.

Keep a small table up to date. A sales ops lead tracks partner leads in an n8n data table. add_data_table_rows inserts the new ones and add_data_table_column adds the field the team asked for.

The part the directory sheet leaves out: nothing works until an instance owner or admin turns on assistant access in n8n, and Claude can only open, run or modify workflows someone has marked as available to it. Previews of everything you can see still show up in searches. Claude does not run in the background either: it acts while you talk to it, and the scheduled runs stay n8n's job. If you want to wire n8n into other apps rather than talk to it, the n8n integrations pages cover that side.

Vocabulary

The vocabulary in one minute

Five words you will meet while connecting n8n.

Connector
The link you set up once between Claude and an account you already have, so Claude can work in it while it answers you.
Tool
One named thing a connector lets Claude do. Claude picks the ones it needs on its own; the directory lists them by name.
Authorization
The service's own sign-in screen, where you hand Claude the access it will use. Given once per person, and revocable.
Approval
The confirmation Claude waits for before it goes ahead with something that changes your account, shown in the chat when it matters.
MCP
The shared standard connectors are built on: it is what lets an assistant like Claude talk to an outside service.
Connect

Connect n8n to Claude in three steps

  1. 01

    Find n8n in the list

    In Claude's settings, open Customize, then Connectors, and look for n8n. On a Team or Enterprise workspace, an Owner or Primary Owner has to enable the connector first before each member can sign in.

  2. 02

    Start the connection

    Click Connect on its row, then sign in to your n8n instance in the window n8n opens itself. If the link breaks one day, use Disconnect and connect it again from the same row.

  3. 03

    Read the authorization screen

    Read n8n's authorization screen before you approve. It belongs to n8n, not to Claude, and it sets what this client may do, for example read workflows without running them. You can revoke it later in n8n.

Tools

The 27 n8n tools, grouped by what they do

n8n gives Claude 27 tools: 14 that read your account, 13 that change something in it.

Two groups: what Claude reads in your instance, and what it runs, publishes or changes. Names stay the ones the directory sheet shows; n8n has since renamed four of them and replaced a fifth.

  • 14 read
  • 13 write

What Claude reads (14)

14 tools

Fourteen tools that look at workflows, runs, nodes, credentials and projects without touching them.

search_workflows

Looks through the workflows you have access to, with optional filters, and returns a preview of each one rather than its full content.

When it helps
you remember a workflow about invoices but not its name or its project.
Watch out
n8n notes this search sees every workflow you can view, even those not made available to Claude.

Sourcedocs.n8n.io · September 30, 2026 ↗

get_execution

Opens one run of a workflow from its identifiers and returns its metadata by default, with the full data only when asked. n8n has renamed it since version 2.34.0.

When it helps
the overnight sync failed and you want to see at which step and with what error.

Sourcedocs.n8n.io · September 30, 2026 ↗

search_executions

Filters the history of runs and returns each one's status, timing and workflow. n8n's reference now lists it under a newer name.

When it helps
you want every failed run of the last day across all workflows before your morning stand-up.

Sourcedocs.n8n.io · September 30, 2026 ↗

get_workflow_details

Returns the full description of one workflow, trigger details included.

When it helps
before running something, Claude checks how it starts.
Watch out
the full detail only opens for workflows someone made available to Claude in n8n; searches show previews of the others.

Sourcedocs.n8n.io · September 30, 2026 ↗

prepare_test_pin_data

Works out which nodes of a workflow need sample data for a test and returns the expected shape of that data for each of them. It carries a new name in recent n8n versions.

When it helps
Claude wants to test a workflow that calls your CRM without touching the real CRM.

Sourcedocs.n8n.io · September 30, 2026 ↗

list_credentials

Lists the credentials your account can use, so Claude can point a node at the right one. The secret values themselves are never returned.

When it helps
a new workflow needs the Slack connection your team already set up, not a duplicate.

Sourcedocs.n8n.io · September 30, 2026 ↗

search_data_tables

Finds the data tables your account can access and gives back their identifiers, the step Claude takes before touching any of them.

When it helps
you ask Claude to add rows to the partner table and it first has to find which one that is.

Sourcedocs.n8n.io · September 30, 2026 ↗

search_nodes

Looks up n8n nodes by service name, trigger type or utility, and returns their identifiers plus the related nodes Claude will need next.

When it helps
you ask for a workflow that posts to Microsoft Teams and Claude needs to know which node does it.

Sourcedocs.n8n.io · September 30, 2026 ↗

get_node_types

Returns the exact parameter names and structures of chosen nodes: the reference Claude consults before it drafts any workflow code, so fields match what n8n expects.

When it helps
a Google Sheets step keeps failing because a field name was guessed wrong.

Sourcedocs.n8n.io · September 30, 2026 ↗

get_suggested_nodes

The only official mention says this tool gave workflow-planning guidance, which n8n has since replaced with a best-practices tool. The exact content it returned is not described anywhere.

When it helps
at the planning stage of a workflow, if your instance still exposes it.

Sourcedocs.n8n.io · September 30, 2026 ↗

validate_workflow

Parses workflow code into a workflow and reports the errors it finds. n8n wants this check run every time, before a workflow is saved.

When it helps
Claude drafted a workflow and wants it clean before you see it in the editor.

Sourcedocs.n8n.io · September 30, 2026 ↗

search_projects

Finds the n8n projects your account can access and resolves a project name into its identifier, so Claude does not guess where things belong.

When it helps
you want the new workflow in the Marketing project, not in your personal space.

Sourcedocs.n8n.io · September 30, 2026 ↗

search_folders

Looks for folders inside a project, which lets Claude place a workflow in the right folder.

When it helps
the ops team keeps all billing workflows in one folder and wants the new one there too.
Watch out
the search runs inside a single project, so the project identifier has to be found first.

Sourcedocs.n8n.io · September 30, 2026 ↗

get_sdk_reference

Returns the reference n8n publishes for building workflows in code: patterns, expression syntax, functions, rules and design guidance. Recent n8n versions expose it under a longer name.

When it helps
Claude reads it first when you ask for a workflow built from scratch, before choosing a single node.

Sourcedocs.n8n.io · September 30, 2026 ↗

What Claude changes (13)

13 tools

Thirteen tools that run, publish, create, edit or delete in your instance. No source describes a Claude confirmation specific to them: the general rule below applies.

execute_workflow

Approval: see the rule

Starts a workflow by its identifier and hands back the run's identifier straight away, without waiting for the end. The workflow does for real whatever it is built to do.

What Claude asks for
no source describes a confirmation for this call, so the general approval rule below is what covers it.
When it helps
you need the weekly export now instead of Monday.
Watch out
in production mode the workflow must already be published.

Sourcedocs.n8n.io · September 30, 2026 ↗

publish_workflow

Approval: see the rule

Activates a workflow for production by turning its current draft into the active version.

What Claude asks for
nothing tool-specific is documented on the Claude side; lean on the approvals section below.
When it helps
the draft passed its test and the team wants it live before a campaign launch.
Watch out
whatever the draft contains goes live with it.

Sourcedocs.n8n.io · September 30, 2026 ↗

unpublish_workflow

Approval: see the rule

Deactivates a workflow so it is no longer available for production runs. The workflow itself stays in the instance.

What Claude asks for
no source says whether Claude prompts first here; the default rule in the approvals block covers it.
When it helps
a workflow keeps sending duplicate emails and you want it stopped while you look.

Sourcedocs.n8n.io · September 30, 2026 ↗

test_workflow

Approval: see the rule

Runs a workflow on sample data: trigger nodes, nodes with credentials and web request nodes are simulated, the others execute for real.

What Claude asks for
the Claude-side prompt is not documented for this tool, so the general rule applies.
When it helps
checking the logic of a new workflow before it ever reaches a customer.
Watch out
credential-free nodes such as file writes or command runs are not simulated.

Sourcedocs.n8n.io · September 30, 2026 ↗

create_data_table

Approval: see the rule

Sets up a new data table in n8n with the columns you specify.

What Claude asks for
no confirmation specific to this tool is described; the approvals block below holds the rule.
When it helps
a small event needs a sign-up list that your workflows can read and fill.

Sourcedocs.n8n.io · September 30, 2026 ↗

rename_data_table

Approval: see the rule

Gives an existing data table a new name, contents untouched.

What Claude asks for
the sources stay silent on a prompt for this call; see the general rule below.
When it helps
a table called test2 became the real list of suppliers and nobody can find it.

Sourcedocs.n8n.io · September 30, 2026 ↗

add_data_table_column

Approval: see the rule

Adds a new column to an existing data table.

What Claude asks for
as for the other table tools, no specific prompt is documented, so the default approval rule applies.
When it helps
the team wants to track a follow-up date next to each lead.

Sourcedocs.n8n.io · September 30, 2026 ↗

delete_data_table_column

Approval: see the rule

Removes a column from a data table along with all the data it held.

What Claude asks for
no source describes a Claude-side confirmation here, which makes the general approval rule your only safeguard.
When it helps
an old field full of outdated notes clutters every export.
Watch out
n8n states this deletion cannot be undone.

Sourcedocs.n8n.io · September 30, 2026 ↗

rename_data_table_column

Approval: see the rule

Changes the name of one column in a data table and leaves its values as they are.

What Claude asks for
nothing is documented for this specific call; refer to the approvals section.
When it helps
a column still called by its import label should say renewal date so the rest of the team understands it.

Sourcedocs.n8n.io · September 30, 2026 ↗

add_data_table_rows

Approval: see the rule

Inserts rows into an existing data table, each row matching column names to values.

What Claude asks for
no source says whether Claude asks before inserting; the general rule below covers it.
When it helps
you paste a list of trade-show contacts and want them in the leads table.
Watch out
n8n caps a single call at 1000 rows.

Sourcedocs.n8n.io · September 30, 2026 ↗

create_workflow_from_code

Approval: see the rule

Turns validated workflow code into a saved workflow in n8n, assigning available credentials to its nodes.

What Claude asks for
no confirmation specific to this tool is described, so the general rule applies.
When it helps
you described a lead-routing flow and want it in your instance, ready to test.
Watch out
web request nodes still need their credentials set by hand.

Sourcedocs.n8n.io · September 30, 2026 ↗

archive_workflow

Approval: see the rule

Archives a workflow in n8n from its identifier.

What Claude asks for
the Claude-side prompt is undocumented here as well, so rely on the approvals block below.
When it helps
a seasonal campaign ended and its workflows clutter the list.

Sourcedocs.n8n.io · September 30, 2026 ↗

update_workflow

Approval: see the rule

Applies an ordered batch of targeted edits to an existing workflow, all or nothing: if one edit fails, none is saved.

What Claude asks for
no source says whether a prompt appears before these edits; the general approval rule is what applies.
When it helps
you want a Slack alert added at the end of a workflow without rebuilding it.

Sourcedocs.n8n.io · September 30, 2026 ↗

Approvals

What Claude asks you before acting

By default, Claude stops and asks for your go-ahead before each action it takes on an account for you. No source describes an n8n-specific confirmation on the Claude side, so that rule covers runs, publications and edits.

n8n adds its own layer. Each connected client only has the permissions granted when it connected, for example reading workflows without being able to create or run them. Workflows must also be marked as available before Claude can open, run or modify them. On a Team or Enterprise workspace, Claude's owners decide whether members may skip prompts and can restrict what the connector may do for the whole organization.

Plans

Which plans this is available on

Out of 819 directory sheets, not one shows availability by plan. The connector-by-connector answer is published nowhere: it is a real gap in the catalogue.

The general rule is public: remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile. On Team and Enterprise, an Owner or Primary Owner turns the connector on for the organization before members can connect. For the current state of this one, check its sheet in the official directory, the only place that shows it.

Limits

Where this connector stops

A connector is not an automation, even when it points at one. Claude calls these tools while it answers you; the schedules, webhooks and background runs remain n8n's own work.

Everything here comes from n8n's documentation and the directory sheet; Claude's help centre has no page on this connector. The tool list is an observed floor, not a promise, and n8n's reference already lists tools the sheet does not show. The verification badge is not a security audit either: Anthropic states on every sheet that it does not choose the tools a publisher exposes. The Integrations hub gathers the rest of the n8n material.

Two official sources disagree

Are the tool names on the directory sheet still the ones n8n exposes?

What this page followsn8n's reference is the more recent source on names, so the sheet's list looks dated. The names Claude actually shows depend on what your own instance exposes. Check the tool list in the connector settings before relying on one.

Need help

Need help connecting n8n to Claude?

A person reads every message.

FAQ

Frequently asked questions about the Claude n8n connector

01What can Claude do with the n8n connector?
Claude can search, inspect, test, run and build workflows in your n8n instance from a conversation. The connector lists twenty-seven tools: searching workflows, runs, projects and folders, reading workflow details and node definitions, validating and creating workflows from code, testing on sample data, running, publishing, unpublishing, updating and archiving workflows, plus managing data tables and their rows. It gives you a conversational way to operate n8n, while n8n keeps running the workflows.
02Can Claude run, change or delete things in n8n?
Yes, thirteen tools act on your instance. They run a workflow, test it on sample data, publish or unpublish it, create one from code, update it through targeted edits, archive it, and create, rename or extend data tables, add rows, rename or delete columns. Deleting a column cannot be undone. Claude can only run or modify workflows someone marked as available in n8n, and the permissions granted to the client at connection time set the ceiling.
03Does Claude ask before it runs or edits a workflow?
By default, yes: Claude asks for confirmation before each action it takes on an account for you. No source describes a Claude-side confirmation specific to an n8n tool, so that default rule covers runs, publications and edits. n8n adds its own limits: the permissions granted to the client when it connected, and the per-workflow switch that makes a workflow available. On Team or Enterprise, Claude's owners can restrict the connector for everyone.
04Which Claude plans is the n8n connector available on?
No official source publishes plan availability connector by connector, and no directory sheet shows it. The general rule says remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile. On Team and Enterprise, an Owner or Primary Owner has to enable the connector before members can sign in individually. The connector's sheet in the official directory is the only place that shows its current state for your account.
05Does Claude see every workflow in our n8n instance?
Not in full. Searches return previews of every workflow your n8n user can view, but Claude can only open the full content, run or modify workflows that someone explicitly made available to connected assistants. Visibility also stays tied to your user: you never see more through Claude than your n8n permissions allow. All connected clients share the same list of available workflows, since n8n does not scope that list per client.
06Why does n8n say I lack permissions when I connect Claude?
Because assistant access is switched off on your instance. n8n's documentation says this message has no other cause for the instance server: while it is off, n8n refuses every authorization request. Ask an instance owner or admin to open the instance settings and switch on assistant access for the instance. Once it is on, connect Claude again and approve the request. n8n places that switch in Settings, under Instance-level MCP, and it takes owner or admin permissions.
07Claude or n8n's own automations for this job?
They cover different moments, so it depends on the task. n8n runs workflows on schedules, webhooks and events, in the background, without anyone watching. Claude works inside a conversation: it helps you find, fix, test or build those workflows while you talk to it, and stops when you stop typing. For something that must happen every night at two, that is n8n's job. For investigating or drafting it, the connector fits.