$git clone https://github.com/czlonkowski/n8n-mcpA Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations. Deploy in minutes to give Claude and other AI assistants deep knowledge about n8n's 2,175 workflow automation nodes (827 core + 1,348
| 1 | # n8n-MCP |
| 2 | |
| 3 | [](https://opensource.org/licenses/MIT) |
| 4 | [](https://github.com/czlonkowski/n8n-mcp) |
| 5 | [](https://www.npmjs.com/package/n8n-mcp) |
| 6 | [](https://codecov.io/gh/czlonkowski/n8n-mcp) |
| 7 | [](https://github.com/czlonkowski/n8n-mcp/actions) |
| 8 | [](https://github.com/n8n-io/n8n) |
| 9 | [](https://github.com/czlonkowski/n8n-mcp/pkgs/container/n8n-mcp) |
| 10 | [](https://railway.com/deploy/n8n-mcp?referralCode=n8n-mcp) |
| 11 | |
| 12 | A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations. Deploy in minutes to give Claude and other AI assistants deep knowledge about n8n's 2,175 workflow automation nodes (827 core + 1,348 community). |
| 13 | |
| 14 | ## Overview |
| 15 | |
| 16 | n8n-MCP serves as a bridge between n8n's workflow automation platform and AI models, enabling them to understand and work with n8n nodes effectively. It provides structured access to: |
| 17 | |
| 18 | - **2,175 n8n nodes** - 827 core nodes + 1,348 community nodes (1,195 verified) |
| 19 | - **Node properties** - 99% coverage with detailed schemas |
| 20 | - **Node operations** - 63.6% coverage of available actions |
| 21 | - **Documentation** - 87% coverage from official n8n docs (including AI nodes) |
| 22 | - **AI tools** - 265 AI-capable tool variants detected with full documentation |
| 23 | - **Real-world examples** - 156 ranked configurations extracted from popular templates |
| 24 | - **Template library** - 2,352 workflow templates with 99.96% AI metadata coverage |
| 25 | - **Community nodes** - Search verified community integrations with `source` filter |
| 26 | |
| 27 | ## Support This Project |
| 28 | |
| 29 | <div align="center"> |
| 30 | <a href="https://github.com/sponsors/czlonkowski"> |
| 31 | <img src="https://img.shields.io/badge/Sponsor-❤️-db61a2?style=for-the-badge&logo=github-sponsors" alt="Sponsor n8n-mcp" /> |
| 32 | </a> |
| 33 | </div> |
| 34 | |
| 35 | **n8n-mcp** started as a personal tool but now helps tens of thousands of developers automate their workflows efficiently. Maintaining and developing this project competes with my paid work. Your sponsorship helps me dedicate focused time to new features, respond quickly to issues, keep documentation up-to-date, and ensure compatibility with latest n8n releases. **[Become a sponsor](https://github.com/sponsors/czlonkowski)** |
| 36 | |
| 37 | ## Important Safety Warning |
| 38 | |
| 39 | **NEVER edit your production workflows directly with AI!** Always: |
| 40 | - Make a copy of your workflow before using AI tools |
| 41 | - Test in development environment first |
| 42 | - Export backups of important workflows |
| 43 | - Validate changes before deploying to production |
| 44 | |
| 45 | AI results can be unpredictable. Protect your work! |
| 46 | |
| 47 | ## Quick Start |
| 48 | |
| 49 | **The fastest way to try n8n-MCP** - no installation, no configuration: |
| 50 | |
| 51 | **[dashboard.n8n-mcp.com](https://dashboard.n8n-mcp.com)** |
| 52 | |
| 53 | - Free tier: 100 tool calls/day |
| 54 | - Instant access: Start building workflows immediately |
| 55 | - Always up-to-date: Latest n8n nodes and templates |
| 56 | - No infrastructure: We handle everything |
| 57 | |
| 58 | Just sign up, get your API key, and connect your MCP client. |
| 59 | |
| 60 | **Want to self-host?** See the [Self-Hosting Guide](./docs/SELF_HOSTING.md) for npx, Docker, Railway, and local installation options. |
| 61 | |
| 62 | ## n8n Integration |
| 63 | |
| 64 | Want to use n8n-MCP with your n8n instance? Check out our comprehensive [n8n Deployment Guide](./docs/N8N_DEPLOYMENT.md) for: |
| 65 | - Local testing with the MCP Client Tool node |
| 66 | - Production deployment with Docker Compose |
| 67 | - Cloud deployment on Hetzner, AWS, and other providers |
| 68 | - Troubleshooting and security best practices |
| 69 | |
| 70 | ### Cloudflare Access Authentication |
| 71 | |
| 72 | If your n8n ins |