# Install n8n-mcp with Homebrew

MCP for Claude Desktop, Claude Code, Windsurf, Cursor to build n8n workflows. Version 2.67.2 via Homebrew; verified 2026-07-31.

## Install

```sh
sudo av install brew:n8n-mcp
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install n8n-mcp
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:n8n-mcp
- **Package manager:** Homebrew
- **Version:** 2.67.2
- **Source summary:** MCP for Claude Desktop, Claude Code, Windsurf, Cursor to build n8n workflows
- **Homepage:** <https://www.n8n-mcp.com/>
- **Last updated:** 2026-07-31T13:04:29Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- n8n-mcp (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.67.2
## 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

- <https://api.github.com/repos/czlonkowski/n8n-mcp>
- <https://api.github.com/repos/czlonkowski/n8n-mcp/releases/latest>
- <https://api.npmjs.org/downloads/point/last-month/n8n-mcp>
- <https://formulae.brew.sh/api/formula/n8n-mcp.json>
- <https://formulae.brew.sh/formula/n8n-mcp>
- <https://github.com/czlonkowski/n8n-mcp>
- <https://github.com/czlonkowski/n8n-mcp/blob/main/docs/DEPENDENCY_UPDATES.md>
- <https://registry.npmjs.org/n8n-mcp>


## Security Notes

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.



## 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

- Unix: .env

## Credential files

- Unix: .env

## Combined YAML source

View the package source record on GitHub. [combined/n8n-mcp.yml](https://github.com/mxcl/pkgdb/blob/main/combined/n8n-mcp.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph