---
title: "n8n MCP server: workflows and data tables for AI agents"
canonical_url: https://cookiesforai.app/mcp/n8n
markdown: https://cookiesforai.app/mcp/n8n.md
publisher: "CookiesForAI"
last_updated: 2026-11-21T12:00:00+01:00
facts_checked: 2026-11-21
type: mcp
summary: "The n8n MCP server gives AI agents access to one n8n instance: they can search, inspect, run, test, build and edit workflows, and work with data tables, using OAuth or a personal access token."
install:
  - for: "Claude Code, signing in with OAuth"
    command: "claude mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/http"
  - for: "Codex CLI, signing in with OAuth"
    command: "codex mcp add n8n --url \"https://<your-n8n-domain>/mcp-server/http\""
  - for: "Gemini CLI"
    command: "gemini mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/http"
  - for: "Claude Code with an API key"
    command: |-
      claude mcp add --transport http n8n-mcp https://<your-n8n-domain>/mcp-server/http \
        --header "Authorization: Bearer <YOUR_N8N_MCP_TOKEN>"
related:
  - "https://cookiesforai.app/mcp/atlassian"
  - "https://cookiesforai.app/mcp/awork"
  - "https://cookiesforai.app/mcp/linear"
  - "https://cookiesforai.app/mcp/meistertask"
---

> Full index of this site: https://cookiesforai.app/llms.txt  
> Checked by CookiesForAI on 21 NOV 2026: repository facts (stars, last push, archived) re-read from GitHub.

# n8n MCP server

The n8n MCP server gives AI agents access to one n8n instance: they can search, inspect, run, test, build and edit workflows, and work with data tables, using OAuth or a personal access token.

## Connect

Claude Code, signing in with OAuth:

```bash
claude mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/http
```

Codex CLI, signing in with OAuth:

```bash
codex mcp add n8n --url "https://<your-n8n-domain>/mcp-server/http"
```

Gemini CLI:

```bash
gemini mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/http
```

Claude Code with an API key:

```bash
claude mcp add --transport http n8n-mcp https://<your-n8n-domain>/mcp-server/http \
  --header "Authorization: Bearer <YOUR_N8N_MCP_TOKEN>"
```

Replace \<your-n8n-domain\> with the domain that serves your n8n editor, without https://. You can copy the full Server URL from Settings > Instance-level MCP > Connect a client. OAuth is the method n8n recommends: Claude Code and Gemini CLI finish it with /mcp, Codex with codex mcp login n8n. The API key method uses a personal access token tied to your user; generating a new one revokes the previous one. n8n's page also shows JSON configs for Cursor, VS Code and Windsurf.

## Ask your coding agent

```text
Connect the n8n MCP server to my coding agent using its documented setup: https://github.com/n8n-io/n8n. Checked by CookiesForAI on 21 NOV 2026: repository facts (stars, last push, archived) re-read from GitHub.
```

## Facts

| Fact | Value |
|---|---|
| Publisher | [n8n](https://n8n.io), official |
| Source | https://github.com/n8n-io/n8n |
| License | Sustainable Use License |
| GitHub stars | 211,594 on 21 NOV 2026 |
| Last code push | 21 NOV 2026 |
| Page updated | 21 NOV 2026 |
| Official MCP Registry | not listed |
| Documented clients | Claude Code, Codex, Gemini CLI, Claude.ai, ChatGPT, Mistral Vibe, Cursor, VS Code, Windsurf, Claude Desktop, Lovable, Google ADK |
| Category | [Notes, docs and team tools](https://cookiesforai.app/mcp/category/productivity) |
| Free tier | Free plan |
| Cost | Part of n8n itself. n8n says its self-hosted Community edition is free, under the Sustainable Use License; hosted n8n Cloud plans have a free trial and are billed by n8n. |
| Current prices | https://n8n.io/pricing/ |
| Facts checked | 21 NOV 2026 ([how](https://cookiesforai.app/method)) |

We do not list prices because vendors change them often. Check the publisher's own page.

## What it does

The n8n MCP server is the instance-level MCP server built into n8n, the workflow automation platform. Instead of exposing one workflow, it connects an AI client to a whole n8n instance. n8n's tool reference groups its tools into workflow management, execution management, credential management, instance context, workflow building, agent management, skills, user preferences and data tables.

Agents can use it to find workflows with search_workflows, read one with get_workflow_details, run one with execute_workflow, and test one with test_workflow. For building, n8n documents search_nodes, validate_workflow, create_workflow_from_code and update_workflow, and a group of data table tools such as search_data_tables. n8n says its agents are in Preview and may change in future releases.

An instance owner or admin turns the server on under Settings > Instance-level MCP with Enable MCP access. That does not expose every workflow: each workflow must also be enabled, or enabled through project or folder toggles (from n8n 2.24.0). n8n says every connected client sees every workflow you have enabled, and you cannot limit a workflow to one client. Building and editing workflows needs n8n 2.13.0 or later.

Tools it gives your agent: `search_workflows`, `get_workflow_details`, `execute_workflow`, `test_workflow`, `publish_workflow`, `get_workflow_execution`, `search_workflow_executions`, `search_nodes`, `validate_workflow`, `create_workflow_from_code`, `update_workflow`, `search_data_tables`

## When to use it

- You want an AI client to run or test selected workflows in your n8n instance.
- You want an agent to build or edit n8n workflows from validated code.
- You want one connection to an n8n instance from a coding agent, chat client or IDE.

## When to pick something else

- Per-client permissions: n8n says clients cannot be limited to certain workflows, so every client sees every workflow you enabled.
- Cloud-based clients with a private instance: n8n says cloud-based clients need a publicly accessible instance.

## What it needs

- An n8n instance with instance-level MCP enabled by an owner or admin (Settings > Instance-level MCP)
- Each workflow enabled for MCP access
- OAuth approval, or the personal access token from the API key tab

## Questions people ask

### Does the n8n MCP server expose all my workflows?

No. n8n says enabling MCP access for the instance does not expose all workflows; you enable each workflow separately, or use project or folder toggles from n8n 2.24.0.

### Does the n8n MCP server work with ChatGPT?

n8n's documentation names ChatGPT, with Claude.ai and Mistral Vibe, among the web clients it supports.

## Related

### Other MCP servers for notes, docs and team tools

- [Atlassian](https://cookiesforai.app/mcp/atlassian): The Atlassian MCP server gives AI agents access to Jira, Confluence, Jira Service Management, Bitbucket, Compass and Loom on Atlassian Cloud: search, summarize, and create or update issues and pages.
- [awork](https://cookiesforai.app/mcp/awork): The awork MCP server gives AI assistants access to the full awork API, including projects, tasks, time entries, users and companies, using the permissions of the signed-in user or API token.
- [Linear](https://cookiesforai.app/mcp/linear): The Linear MCP server gives AI agents access to your Linear workspace through Linear's hosted endpoint: find, create and update issues, projects and comments, with a read-only URL when you only need lookups.
- [MeisterTask](https://cookiesforai.app/mcp/meistertask): The MeisterTask MCP server, in public beta, lets Claude work with the projects, tasks, Notes and mind maps in a Meister account, such as creating projects from a brief, updating task statuses and drafting Notes.
