Deploy n8n-MCP

MCP server that lets AI assistants build and validate n8n workflows

Deploy n8n-MCP

/data

Deploy and Host n8n-MCP on Railway

n8n-MCP is an open-source MCP (Model Context Protocol) server by Romuald Czlonkowski. It gives Claude, ChatGPT, Cursor and other AI assistants a searchable reference of n8n's nodes and templates, validates workflows before you run them, and, with an n8n API key, lets the assistant create, edit, test and debug workflows on your own n8n instance.

About Hosting n8n-MCP

This template runs n8n-MCP 2.102.0 in HTTP mode as one service, built from a public GitHub repo that pins the official image by version and digest. A bearer token (AUTH_TOKEN) is generated at deploy time, and every MCP request must send it. The SQLite database sits on a Railway volume at /data, so the workflow snapshots n8n-MCP saves before each change (used for rollback) survive redeploys and restarts. Railway gives the service an HTTPS domain and checks /health. After deploying, copy AUTH_TOKEN from the service's variables and add https://YOUR-DOMAIN.up.railway.app/mcp to your AI client. You only need n8n itself for the workflow management tools.

Common Use Cases

  • Let Claude Code, Claude Desktop, Cursor or Windsurf look up n8n node properties and operations while building workflows
  • Validate n8n workflows and node settings before deploying them, and auto-fix common mistakes
  • Have an AI assistant create, update, test and roll back workflows on your n8n instance through its API

Dependencies for n8n-MCP Hosting

  • An MCP client that supports remote HTTP servers (Claude Code, Cursor, VS Code), or mcp-remote for stdio-only clients such as Claude Desktop
  • Optional: an n8n instance with its public API enabled and an API key, for the workflow management tools

Deployment Dependencies

Implementation Details

After deploy. Open the n8n-MCP service, copy AUTH_TOKEN from its Variables tab, and connect a client. Claude Code:

claude mcp add --transport http n8n-mcp https://YOUR-DOMAIN.up.railway.app/mcp --header "Authorization: Bearer YOUR-AUTH-TOKEN"

Claude Desktop (stdio only) goes through mcp-remote:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://YOUR-DOMAIN.up.railway.app/mcp", "--header", "Authorization: Bearer YOUR-AUTH-TOKEN"]
    }
  }
}

Connecting n8n (optional). Set N8N_API_URL (your n8n instance's public URL) and N8N_API_KEY (n8n: Settings, n8n API) on the service and redeploy. Without them, the documentation, template and validation tools still work.

Variables. AUTH_TOKEN (generated), N8N_API_URL and N8N_API_KEY (optional), PORT (3000). Other upstream settings such as DISABLED_TOOLS, DISABLED_TOOL_OPERATIONS (read-only setups) and N8N_MCP_TELEMETRY_DISABLED=true (opts out of n8n-MCP's anonymous usage statistics, on by default upstream) can be added as service variables.

Updates. The service builds from the template repo. When a new n8n-MCP release is merged there, Railway shows your project an "update available" notice and you choose when to apply it. On the first start after a version change, the start script installs the new release's node database and carries your workflow snapshots over, keeping the previous file in /data/backup. Changes are listed in the repo's CHANGELOG.md.

Why Deploy n8n-MCP on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying n8n-MCP on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


Template Content

More templates in this category

View Template
Chat Chat
Chat Chat, your own unified chat and search to AI platform.

okisdev
117
View Template
Weaviate
Vector database with hybrid search and an API key-protected API

GitHub Locker
1
View Template
Möbius Personal AI OS
Self-hosted AI agent that builds and runs apps for you, with memory.

bento
1