# Install n8n-mcp with Homebrew

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

## 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
- **Package manager page:** <https://formulae.brew.sh/formula/n8n-mcp>
- **Version:** 2.63.1
- **Source summary:** MCP for Claude Desktop, Claude Code, Windsurf, Cursor to build n8n workflows
- **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
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- n8n-mcp (cli)
- n8n-mcp (alias)

## Dependencies

- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.63.1
- Package-manager updated: 2026-07-07
- Local data: ok
- Upstream repository: https://www.n8n-mcp.com/
- info: Release/tag comparison is only available for GitHub repositories.
## 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
## 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


## Related links

- [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [notion-mcp-server](https://www.automicvault.com/pkg/brew/notion-mcp-server/) - Shares av.db curated category or tags: cli, developer-tools, mcp, typescript.
- [salesforce-mcp](https://www.automicvault.com/pkg/brew/salesforce-mcp/) - Shares av.db curated category or tags: cli, developer-tools, mcp, typescript.
- [airtable-mcp-server](https://www.automicvault.com/pkg/brew/airtable-mcp-server/) - Shares av.db curated category or tags: cli, developer-tools, mcp.
- [bash-language-server](https://www.automicvault.com/pkg/brew/bash-language-server/) - Shares av.db curated category or tags: cli, developer-tools, typescript.
- [bit](https://www.automicvault.com/pkg/brew/bit/) - Shares av.db curated category or tags: cli, developer-tools, typescript.
- [bumpp](https://www.automicvault.com/pkg/brew/bumpp/) - Shares av.db curated category or tags: cli, developer-tools, typescript.
- [changelogen](https://www.automicvault.com/pkg/brew/changelogen/) - Shares av.db curated category or tags: cli, developer-tools, typescript.
- [chrome-devtools-mcp](https://www.automicvault.com/pkg/brew/chrome-devtools-mcp/) - Shares av.db curated category or tags: cli, developer-tools, mcp.
- [n8n-mcp](https://www.automicvault.com/pkg/npm/n8n-mcp/) - Same normalized package name appears in another local ecosystem. Shared terms: automation, integration, mcp, n8n, n8n-mcp.
- [claudekit](https://www.automicvault.com/pkg/brew/claudekit/) - Both packages touch the same language runtime or ecosystem. Shared terms: automation, claude, cli, code, developer.
- [claude-hooks](https://www.automicvault.com/pkg/brew/claude-hooks/) - Both packages touch the same language runtime or ecosystem. Shared terms: automation, claude, cli, code, developer.
- [n8n-mcp](https://www.automicvault.com/pkg/npm/n8n-mcp/) - Same normalized package name in another local ecosystem.

## Combined YAML source

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


## Sources

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