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
claude mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/httpCodex CLI, signing in with OAuth
codex mcp add n8n --url "https://<your-n8n-domain>/mcp-server/http"Gemini CLI
gemini mcp add --transport http n8n https://<your-n8n-domain>/mcp-server/httpClaude Code with an API key
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_workflowsget_workflow_detailsexecute_workflowtest_workflowpublish_workflowget_workflow_executionsearch_workflow_executionssearch_nodesvalidate_workflowcreate_workflow_from_codeupdate_workflowsearch_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.
Other MCP servers for notes, docs and team tools
- 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: 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: 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: 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.