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.

Checked by CookiesForAI on : repository facts (stars, last push, archived) re-read from GitHub.

Written by

Connect n8n

Claude Code, signing in with OAuth

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

Codex CLI, signing in with OAuth

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

Gemini CLI

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

Claude Code with an API key

Terminal
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.

Or paste this into your coding agent: Connect the n8n MCP server to my coding agent using its documented setup: https://github.com/n8n-io/n8n. Checked by CookiesForAI on : repository facts (stars, last push, archived) re-read from GitHub.

What the n8n MCP server 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 n8n

  • 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 n8n 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

What the n8n MCP server costs

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: n8n.io . We do not list prices because vendors change them often. Check the publisher's own page.

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.