install

Additional install commands

macOS

Homebrewverified · 100%

brew install n8n-mcp

local Homebrew formula metadata

overview

Package summary

MCP for Claude Desktop, Claude Code, Windsurf, Cursor to build n8n workflows

Project links

Commands and aliases

n8n-mcp

history

Project history and usage

n8n-mcp is a Model Context Protocol server that exposes n8n workflow, node, property, operation, template, and validation knowledge to AI coding and agent tools. The repository was created on June 7, 2025, and the npm package was created on July 6, 2025, making it a fast-rising package from the post-MCP boom rather than an old n8n core component.

Project history

The project started as an independent tool by Marcin Czlonkowski and evolved into a TypeScript MCP server with hosted and self-hosted paths. Its README describes coverage for 2,063 n8n nodes, 2,352 workflow templates, structured node properties, operations, official-doc coverage, AI-capable node variants, and real-world examples from templates. The same README says it began as a personal tool and now helps tens of thousands of developers.

Adoption history

The adoption curve is unusually steep for a 2025 project. On July 1, 2026 the GitHub API showed 22,074 stars and 3,553 forks. npm reported 541,219 downloads for May 30, 2026 through June 28, 2026, and Homebrew reported 4,348 installs over 365 days. Homebrew's package is a secondary distribution channel beside npm, Docker, Railway, hosted dashboard access, and IDE/client configuration snippets.

How it is used

Users connect n8n-mcp to Claude Desktop, Claude Code, VS Code/Copilot, Cursor, Windsurf, Codex, or similar MCP clients so the assistant can search n8n nodes, inspect node schemas, find templates, validate node configs, and create or update workflows. Its own prompt guidance pushes a practical workflow: search templates first, inspect nodes with examples, explicitly set parameters instead of trusting defaults, validate individual nodes, then validate whole workflows before deployment.

Why package nerds care

The package is significant because it turns n8n from a mostly UI-driven automation product into a schema-rich target for AI-assisted workflow generation. It also illustrates a new packaging pattern: a project that is simultaneously an npm package, Docker image, Homebrew formula, hosted API, and tool-specific instruction bundle. The main maintenance pressure is keeping pace with n8n's fast release and node-template ecosystem.

Timeline

2025-06-07: GitHub repository created.
2025-07-06: npm package created.
2026-06-26: v2.61.0 published on GitHub and npm metadata updated.
2026-05-30 to 2026-06-28: npm reported 541,219 downloads.
2026-07-01: GitHub API showed 22,074 stars and Homebrew API showed 4,348 installs over 365 days.

Related projects

n8n
Model Context Protocol
Claude Desktop
Claude Code
Cursor
Windsurf
Codex

Sources

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for n8n-mcp. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 1 platform targets.
Installs with 1 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: .env

Credential files

Credential-bearing paths to review before unattended agent runs.

Unix: .env

executables

Installed executables

Command	Kind	Exposure	Note
`n8n-mcp`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version2.63.1

manager updated2026-07-07

local dataok

upstreamnot checked

latest detectednot detected

https://www.n8n-mcp.com/

infoRelease/tag comparison is only available for GitHub repositories.https://www.n8n-mcp.com/none confidence

install metadata

Package metadata

Package key	brew:n8n-mcp
Version	2.63.1
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/n8n-mcp
Homepage	https://www.n8n-mcp.com/
Repository	https://github.com/czlonkowski/n8n-mcp
Upstream docs	https://github.com/czlonkowski/n8n-mcp#readme
License	MIT
Source archive	https://registry.npmjs.org/n8n-mcp/-/n8n-mcp-2.63.1.tgz
Last updated	2026-07-07T12:34:42Z
Pulse	updated
Dependencies	node
Bottle	available (on all)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	n8n-mcp
Version Scheme	0
Revision	0
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	stable

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/n8n-mcp.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
package relationship graph
package version freshness
package-page enrichment

Install n8n-mcp with Homebrew