n8n Community Nodes MCP Server

A focused MCP server for:

• Community n8n packages from npm
• Official n8n docs and built-in nodes from n8n-io/n8n-docs

Why use this

• Discover and search community n8n nodes directly from your AI assistant
• Access official n8n documentation without leaving your editor
• Context-optimized responses using TOON format to save tokens

Smart search

Searches run in parallel across multiple npm tags, results are deduplicated and ranked:

| Signal | Weight | |-------------|--------| | Name match | 40% | | Tag match | 30% | | Description | 20% | | Popularity | 10% |

Filler phrases are stripped from queries — "how to send slack messages" and "slack messages" return the same results.

Token-efficient responses (TOON)

All responses are encoded in TOON (Token-Oriented Object Notation) — a compact format designed for LLMs. Instead of repeating JSON keys in every object, TOON declares them once and streams rows:

[10]{package,name,description,version,downloadsLastWeek}:
 n8n-nodes-slack-bolt,Slack Bolt,Advanced Slack integration,1.2.0,340
 n8n-nodes-discord,Discord,Discord bot nodes for n8n,0.9.1,210
 ...

30–60% fewer tokens per response — more room in context, lower cost per call.

Recommended (Hosted MCP)

Use the hosted endpoint by default:

• https://n8n-community-mcp.masmoudi.dev/mcp

Quick setup (hosted)

Claude Desktop

{
  "mcpServers": {
    "n8n-community": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "--http",
        "https://n8n-community-mcp.masmoudi.dev/mcp",
        "--allow-http"
      ]
    }
  }
}

Claude Code

claude mcp add --transport http n8n-community https://n8n-community-mcp.masmoudi.dev/mcp

Cursor

{
  "mcpServers": {
    "n8n-community": {
      "url": "https://n8n-community-mcp.masmoudi.dev/mcp"
    }
  }
}

Codex

[mcp_servers.n8n-community]
url = "https://n8n-community-mcp.masmoudi.dev/mcp"

Tools

Community npm tools

• search → Search community npm packages only
• list → List community npm packages only
• docs → Get community npm package metadata + optional README

Official n8n docs tools

• search_official_nodes → Search official built-in nodes from n8n-io/n8n-docs
• get_official_node_docs → Get official node docs markdown
• search_n8n_docs_pages → Search official docs pages
• get_n8n_docs_page → Get full docs page markdown by path

Self-host (Optional)

If you want your own instance:

npm install
npm run build
node dist/index.js

Or with an explicit path:

node /path/to/n8n-community-nodes-mcp/dist/index.js

Environment variables

• MCP_HOST (default: 127.0.0.1)
• MCP_PORT (default: 3333)

Local endpoint:

• http://127.0.0.1:3333/mcp

Local client config (self-hosted)

Use the same client snippets as above, but replace URL with:

• http://127.0.0.1:3333/mcp

Notes

• Official docs data source is GitHub (unauthenticated): n8n-io/n8n-docs.
• Example path for get_n8n_docs_page:
  • docs/integrations/builtin/core-nodes/n8n-nodes-base.code.md

License

MIT — see LICENSE.