Introducing Instance‑level MCP access in n8n (Beta)

We just released instance‑level MCP access in n8n, currently in beta. With a single connection to your instance, MCP clients can discover multiple workflows, read details about them, and run them.

:light_bulb: Please note: MCP access must be turned on at both the instance and workflow level to be available to MCP clients (see details below)

Beta status and versions

This feature is currently in beta.

The Search Workflows and Get Workflow Details tools are in the latest release as of version 1.120 The Execute Workflow tool was added to the next in release as of version 1.121

The near-term goal is for these MCP toolsets to graduate from beta once we address the feedback gathered during the beta period.

For more information and troubleshooting, check out the docs at: https://docs.n8n.io/advanced-ai/accessing-n8n-mcp-server/

What you can do with an MCP client

This feature simplifies integration and improves visibility across AI platforms that support MCP, helping you use your n8n workflows directly in the tools where you already work and experiment. You can list and search workflows you’ve enabled for MCP, retrieve workflow details to understand their purpose before running them, and execute eligible workflows from an AI client session. Workflow triggers currently supported for exposure include webhook, chat, form, and schedule.

How to try it

  1. Enable instance‑level access

    • In n8n, go to instance Settings → MCP Access and enable MCP access.

    • Choose OAuth2 or generate an access token.

    • You can revoke specific clients later in the same settings page. [1]

  2. Expose specific workflows

    • Open a workflow → Settings → toggle “Available in MCP.” Only workflows you explicitly enable are exposed.
  3. Add the server in your AI client

    • Configure the client with your instance’s MCP server URL and your chosen auth method.

    • Adding short, human‑readable descriptions to workflows helps clients select the right one.

How this differs from the MCP Server Trigger node

Instance‑level MCP access provides one connection per instance with centralized authentication and per‑workflow opt‑in so that enabled workflows across your instance are discoverable and runnable without bespoke server setup in each workflow.

The MCP Server Trigger node is configured inside a single workflow and exposes tools only from that workflow, which is useful when you want to craft a specific MCP server behavior within one workflow.

What it’s not

  • Instance‑level MCP access is not a way to build or edit workflows from an AI client; authoring remains in n8n.

  • It is not blanket exposure. You must enable MCP at the instance level and then enable each workflow individually.

  • It is not per‑client scoping - any connected client sees all workflows you’ve enabled for MCP at this time.

Notes on safety and access

There is a two‑level opt‑in, at the instance level and per workflow. Both OAuth2 and access token authentication are supported, and you can revoke client access in “Settings → MCP Access”

If you run into issues during setup, the documentation page includes connection instructions, eligibility rules, and troubleshooting steps. https://docs.n8n.io/advanced-ai/accessing-n8n-mcp-server/

Let us know what you think!

8 Likes

This is awesome!

I have an issue when trying to connect to Lovable.

I copied my MCP URL from n8n, pasted into Lovable, clicked Allow, and then get the below:

value too long for type character varying (255)

1 Like

I have the same issue & error-message. n8n shos that lovable is connected but it seems this error prevents some callback to lovable so it is a one-sided success.
n8n self-hosted 1.121.0 on docker and public reachable server.

@barty-bart and @nabossha
We’ve identified the issue which is related to self-hosted n8n instances and are in the process of getting this fixed.

2 Likes

The fix is just released with 1.121.2. Thanks everybody for the patience.

2 Likes

connecting lovable with self-hosted n8n works now, thank you very much! @Ophir_Prusak and @milorad

1 Like

I’ve added the MCP URL to my client and I’ve made sure to enable a webhook-based workflow MCP access in the Workflow Settings. I only see search_workflows and get_workflow_details as tools. Am I missing something? Should there be a tool for actually triggering a workflow?

I tried re-adding the MCP server to my client after enabling MCP access in a workflow, thinking it may need a “refresh”, but I still only see the two tools mentioned above.

@StreamlinedStartup
Please make sure you are on the latest stable version of n8n. The execute workflow tool was added one minor version after the other tools.

Thanks for the heads up.

Was on 1.120.4, which I thought was latest when I posted this, but guess not. Now on 1.121.2 (released 2025-11-20 for those curious) and confirmed working.

I have a problem with my mcp client Gemini CLI, can’t connect.
Err msg: ✕ Error during discovery for server ‘n8n-MCP’: Connection failed for ‘n8n-MCP’: SSE error:
Non-200 status code (404)
Is the problem n8n-mcp server or with my client?

v. 1.122.4 self-hosted n8n with docker, public available url.