Skip to content
Back to search

mcp-n8n-workflow-builder

AI-powered n8n workflow automation through natural language. MCP server enabling Claude AI & Cursor IDE to create, manage, and monitor workflows via Model Context Protocol. Multi-instance support, 17 tools, comprehensive docs. Build workflows conversationally without manual JSON editing.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/salacoste--mcp-n8n-workflow-builder/badge.svg)](/listings/salacoste--mcp-n8n-workflow-builder)

HTML

<a href="/listings/salacoste--mcp-n8n-workflow-builder"><img src="/api/listings/salacoste--mcp-n8n-workflow-builder/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- **Node.js** v14+ (v18+ recommended) - **npm** v7+ - **n8n instance** with API access (tested with n8n v1.82.3+) - **Claude Desktop** or **Cursor IDE**

Installation

# Install globally via npm
npm install -g @kernel.salacoste/n8n-workflow-builder

# Verify installation
npx @kernel.salacoste/n8n-workflow-builder --version

Configuration

Option 1: Multi-Instance (Recommended)

Create `.config.json` in your project root:

{
  "environments": {
    "production": {
      "n8n_host": "https://n8n.example.com",
      "n8n_api_key": "your_production_api_key"
    },
    "staging": {
      "n8n_host": "https://staging.n8n.example.com",
      "n8n_api_key": "your_staging_api_key"
    },
    "development": {
      "n8n_host": "http://localhost:5678",
      "n8n_api_key": "your_dev_api_key"
    }
  },
  "defaultEnv": "development"
}

Option 2: Single Instance (Backward Compatible)

Create `.env` file:

N8N_HOST=https://your-n8n-instance.com
N8N_API_KEY=your_api_key

Claude Desktop Integration

Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["@kernel.salacoste/n8n-workflow-builder"]
    }
  }
}

**Restart Claude Desktop** and you're ready to go! ๐ŸŽ‰

Cursor IDE Integration

Add to `.cursor/mcp.json` in your workspace:

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["@kernel.salacoste/n8n-workflow-builder"]
    }
  }
}

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md ยท README ยท 578 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # n8n Workflow Builder MCP Server
  3. ### AI-Powered Workflow Automation Through Natural Language
  4. Build, manage, and monitor n8n workflows using **Claude AI** and **Cursor IDE** via the **Model Context Protocol**
  5. [![Documentation](https://img.shields.io/badge/docs-latest-blue?style=flat-square&logo=readthedocs)](https://salacoste.github.io/mcp-n8n-workflow-builder/)
  6. [![npm version](https://img.shields.io/npm/v/@kernel.salacoste/n8n-workflow-builder?style=flat-square&logo=npm)](https://www.npmjs.com/package/@kernel.salacoste/n8n-workflow-builder)
  7. [![npm downloads](https://img.shields.io/npm/dm/@kernel.salacoste/n8n-workflow-builder?style=flat-square&logo=npm)](https://www.npmjs.com/package/@kernel.salacoste/n8n-workflow-builder)
  8. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
  9. [Features](#-key-features) โ€ข [Quick Start](#-quick-start) โ€ข [Documentation](https://salacoste.github.io/mcp-n8n-workflow-builder/) โ€ข [Examples](#-examples) โ€ข [API Reference](https://salacoste.github.io/mcp-n8n-workflow-builder/api/overview/)
  10. ![AI-Powered Workflow Builder - Build n8n workflows with natural language](./docs/assets/images/readme_01.jpg)
  11. </div>
  12. ---
  13. ## ๐ŸŽฏ What is This?
  14. **n8n Workflow Builder MCP Server** transforms workflow automation by enabling you to create and manage n8n workflows through **conversational AI**. No more manual JSON editing or complex UI navigationโ€”just describe what you need in natural language, and let AI build it for you.
  15. ### The Problem It Solves
  16. - โŒ **Manual workflow building** is time-consuming and error-prone
  17. - โŒ **Complex JSON editing** requires deep technical knowledge
  18. - โŒ **Switching between IDE and n8n UI** breaks your development flow
  19. - โŒ **Managing multiple n8n environments** (dev, staging, prod) is tedious
  20. ### The Solution
  21. - โœ… **Build workflows conversationally** using Claude AI or Cursor IDE
  22. - โœ… **Natural language interface** - describe workflows in plain English
  23. - โœ… **Multi-instance support** - manage dev, staging, and production from one place
  24. - โœ… **17 powerful tools** - complete workflow lifecycle management
  25. - โœ… **Stay in your IDE** - no context switching required
  26. ---
  27. ## โœจ Key Features
  28. <table>
  29. <tr>
  30. <td width="50%">
  31. ### ๐Ÿค– AI-Powered Workflow Creation
  32. Create complex n8n workflows by simply describing what you need. Claude AI and Cursor IDE understand your intent and generate production-ready workflows.
  33. ### ๐ŸŒ Multi-Instance Management
  34. Seamlessly manage multiple n8n environments (production, staging, development) from a single MCP server with intelligent instance routing.
  35. ### ๐Ÿ› ๏ธ 17 Comprehensive Tools
  36. Complete workflow lifecycle coverage:
  37. - **8 Workflow Tools** - Create, update, delete, activate, execute
  38. - **4 Execution Tools** - Monitor, retry, analyze runs
  39. - **5 Tag Tools** - Organize and categorize workflows
  40. - **6 Credential Tools** (Epic 2) - Secure credential management
  41. </td>
  42. <td width="50%">
  43. ### ๐Ÿ’ฌ Natural Language Interface
  44. No JSON editing required. Build workflows like this:
  45. > "Create a webhook workflow that validates customer emails, sends a Slack notification, and stores data in PostgreSQL"
  46. ### ๐Ÿ”’ Secure by Design
  47. - Built-in credential protection
  48. - API key encryption
  49. - Secure multi-instance configuration
  50. - Never exposes sensitive data in logs
  51. ### ๐Ÿ“š Comprehensive Documentation
  52. - **38+ documentation pages** with guides and tutorials
  53. - **Interactive examples** and workflow patterns
  54. - **Troubleshooting guides** and FAQs
  55. - **API reference** with complete tool documentation
  56. </td>
  57. </tr>
  58. </table>
  59. ---
  60. ## ๐Ÿš€ Quick Start
  61. ### Prerequisites
  62. - **Node.js** v14+ (v18+ recommended)
  63. - **npm** v7+
  64. - **n8n instance** with API access (tested with n8n v1.82.3+)
  65. - **Claude Desktop** or **Cursor IDE**
  66. ### Installation
  67. ```bash
  68. # Install globally via npm
  69. npm install -g @kernel.salacoste/n8n-workflow-builder
  70. # Verify installation
  71. npx @kernel.salacoste/n8n-workflow-builder --version
  72. ```
  73. ### Configuration
  74. #### Option 1: Multi-Instance (Recommended)
  75. Create `.config.json` in your project root:
  76. ```json
  77. {
  78. "environments": {
  79. "production": {
  80. "n8n_host": "https://n8n.example.com",
  81. "n8n_api_key": "your_production_api_key"
  82. },
  83. "staging": {
  84. "n8n_host": "https://staging.n8n.example.com",
  85. "n8n_api_key": "your_staging_api_key"
  86. },
  87. "development": {
  88. "n8n_host": "http://localhost:5678",
  89. "n8n_api_key": "your_dev_api_key"
  90. }
  91. },
  92. "defaultEnv": "development"
  93. }
  94. ```
  95. #### Option 2: Single Instance (Backward Compatible)
  96. Create `.env` file:
  97. ```bash
  98. N8N_HOST=https://your-n8n-instance.com
  99. N8N_API_KEY=your_api_key
  100. ```
  101. ### Claude Desktop Integration
  102. Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
  103. ```json
  104. {
  105. "mcpServers": {
  106. "n8n-workflow-builder": {
  107. "command": "npx",
  108. "args": ["@kernel.salacoste/n8n-workflow-builder"]
  109. }
  110. }
  111. }
  112. ```
  113. **Restart Claude Desktop** and you're ready to go! ๐ŸŽ‰
  114. ### Cursor IDE Integration
  115. Add to `.cursor/mcp.json` in your workspace:
  116. ```json
  117. {
  118. "mcpServers": {
  119. "n8n-workflow-builder": {
  120. "command": "npx",
  121. "args": ["@kernel.salacoste/n8n-workflow-builder"]
  122. }
  123. }
  124. }
  125. ```
  126. ---
  127. ## ๐Ÿ“– Complete Documentation
  128. **Explore our comprehensive documentation site:**
  129. ๐ŸŒ **[Full Documentation](https://salacoste.github.io/mcp-n8n-workflow-builder/)**
  130. ### Quick Links
  131. | Section | Description |
  132. |---------|-------------|
  133. | ๐Ÿš€ [Quick Start Tutorial](https://salacoste.github.io/mcp-n8n-workflow-builder/getting-started/quick-start/first-workflow/) | Build your first workflow in 5 minutes |
  134. | ๐Ÿ“ฆ [Installation Guide](https://salacoste.github.io/mcp-n8n-workflow-builder/getting-started/installation/npm-installation/) | Detailed setup instructions |
  135. | ๐Ÿ”ง [Configuration](https://salacoste.github.io/mcp-n8n-workflow-builder/getting-started/installation/configuration/) | Multi-instance and environment setup |
  136. | ๐Ÿ› ๏ธ [API Reference](https://salacoste.github.io/mcp-n8n-workflow-builder/api/overview/) | Complete tool documentation |
  137. | ๐Ÿ—๏ธ [Multi-Instance Setup](https://salacoste.github.io/mcp-n8n-workflow-builder/multi-instance/overview/) | Manage multiple n8n environments |
  138. | ๐Ÿ’ก [Usage Patterns](https://salacoste.github.io/mcp-n8n-workflow-builder/guides/claude-desktop-patterns/) | Best practices and conversation patterns |
  139. | ๐Ÿ› [Troubleshooting](https://salacoste.github.io/mcp-n8n-workflow-builder/troubleshooting/faq/) | Common issues and solutions |
  140. ---
  141. ## ๐ŸŽจ Examples
  142. ### Example 1: Create a Webhook Workflow
  143. **You:**
  144. > Create a webhook workflow in staging that:
  145. > - Receives POST requests at /customer-signup
  146. > - Validates email and name fields
  147. > - Sends welcome email via Gmail
  148. > - Stores customer in PostgreSQL
  149. **Claude:** โœ… Creates complete workflow with validation, email, and database nodes
  150. ### Example 2: Multi-Instance Workflow Management
  151. **You:**
  152. > List all active workflows in production that haven't run in the last 7 days
  153. **Claude:** ๐Ÿ“Š Analyzes production environment and identifies stale workflows
  154. ### Example 3: Debug Failed Executions
  155. **You:**
  156. > Debug workflow 456 in production - it's been failing with errors
  157. **Claude:** ๐Ÿ” Retrieves execution history, identifies root cause, and suggests fixes
  158. ### Example 4: Credential Management
  159. **You:**
  160. > Show me the schema for OAuth2 credentials, then help me create credentials for Google Sheets API
  161. **Claude:** ๐Ÿ” Retrieves credential schema and guides you through secure credential creation
  162. ---
  163. ## ๐Ÿ› ๏ธ MCP Tools Reference
  164. ### Workflow Management (8 tools)
  165. | Tool | Description | Example Use Case |
  166. |------|-------------|------------------|
  167. | `list_workflows` | List all workflows with filtering | "Show me active workflows in production" |
  168. | `get_workflow` | Retrieve complete workflow details | "Get workflow 123 from staging" |
  169. | `create_workflow` | Build new workflows from scratch | "Create a daily report workflow" |
  170. | `update_workflow` | Modify existing workflows | "Add error handling to workflow 456" |
  171. | `delete_workflow` | Remove workflows | "Delete workflow 789" |
  172. | `activate_workflow` | Enable workflow execution | "Activate workflow 123" |
  173. | `deactivate_workflow` | Disable workflow execution | "Deactivate workflow 456" |
  174. | `execute_workflow` | Manually trigger workflow runs | "Execute workflow 789 with test data" |
  175. ### Execution Management (4 tools)
  176. | Tool | Description | Example Use Case |
  177. |------|-------------|------------------|
  178. | `list_executions` | View execution history with filters | "Show failed executions from today" |
  179. | `get_execution` | Detailed execution information | "Get execution 9876 details" |
  180. | `delete_execution` | Remove execution records | "Delete old test executions" |
  181. | `retry_execution` | Retry failed workflow runs | "Retry execution 9876" |
  182. ### Tag Management (5 tools)
  183. | Tool | Description | Example Use Case |
  184. |------|-------------|------------------|
  185. | `list_tags` / `get_tags` | Retrieve all workflow tags | "Show all workflow tags" |
  186. | `get_tag` | Get specific tag information | "Get tag details for 'email-automation'" |
  187. | `create_tag` | Create workflow organization tags | "Create tag 'customer-workflows'" |
  188. | `update_tag` | Modify tag information | "Rename tag to 'legacy-workflows'" |
  189. | `delete_tag` | Remove workflow tags | "Delete tag 'deprecated'" |
  190. ### Credential Management (6 tools - Epic 2)
  191. | Tool | Description | Example Use Case |
  192. |------|-------------|------------------|
  193. | `get_credential_schema` | Get credential type JSON schema | "Show schema for httpBasicAuth" |
  194. | `list_credentials` | Security guidance (blocked by n8n API) | "List credentials guidance" |
  195. | `get_credential` | Security guidance (blocked by n8n API) | "Get credential guidance" |
  196. | `create_credential` | Create credentials with schema validation | "Create Gmail OAuth2 credentials" |
  197. | `update_credential` | Immutability guidance (DELETE + CREATE) | "Update credential guidance" |
  198. | `delete_credential` | Permanently remove credentials | "Delete credential 123" |
  199. ---
  200. ## ๐Ÿ—๏ธ Multi-Instance Architecture
  201. Manage multiple n8n environments with intelligent routing:
  202. ```
  203. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  204. โ”‚ MCP Server (Single Instance) โ”‚
  205. โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
  206. โ”‚ โ”‚
  207. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  208. โ”‚ โ”‚ ConfigLoaderโ”‚ EnvironmentMgr โ”‚
  209. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  210. โ”‚ โ”‚ โ”‚ โ”‚
  211. โ”‚ โ–ผ โ–ผ โ”‚
  212. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
  213. โ”‚ โ”‚ Instance Routing โ”‚ โ”‚
  214. โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
  215. โ”‚ โ”‚ โ”‚
  216. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  217. โ”‚
  218. โ”Œโ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  219. โ”‚ โ”‚ โ”‚ โ”‚
  220. โ–ผ โ–ผ โ–ผ โ–ผ
  221. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  222. โ”‚ Dev โ”‚ โ”‚Staging โ”‚ โ”‚ Prod โ”‚ โ”‚Custom โ”‚
  223. โ”‚ n8n โ”‚ โ”‚ n8n โ”‚ โ”‚ n8n โ”‚ โ”‚ n8n โ”‚
  224. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  225. ```
  226. **Benefits:**
  227. - โœ… Single MCP server manages all environments
  228. - โœ… Automatic instance routing based on context
  229. - โœ… Separate API keys per environment
  230. - โœ… Easy environment switching in conversations
  231. ---
  232. ## ๐ŸŽฏ Use Cases
  233. ### ๐Ÿš€ Development Workflow
  234. 1. **Build in Development:** Create and test workflows locally
  235. 2. **Deploy to Staging:** Validate in QA environment
  236. 3. **Promote to Production:** Deploy with confidence
  237. ### ๐Ÿ“Š Operations & Monitoring
  238. - Monitor execution status across environments
  239. - Debug failed workflows with detailed analysis
  240. - Track workflow performance and reliability
  241. ### ๐Ÿ”„ Workflow Migration
  242. - Export workflows from one instance
  243. - Import to another with automatic adaptation
  244. - Bulk operations across environments
  245. ### ๐Ÿ“ Documentation & Learning
  246. - Generate workflow documentation automatically
  247. - Learn n8n patterns through AI guidance
  248. - Explore workflow examples and templates
  249. ---
  250. ## ๐Ÿ”’ Security & Best Practices
  251. ### Credential Protection
  252. - โœ… `.config.json` automatically excluded from git via `.gitignore`
  253. - โœ… API keys never logged (only first 20 characters shown)
  254. - โœ… Credentials encrypted by n8n API
  255. - โœ… No sensitive data in npm packages
  256. ### Multi-Instance Security
  257. - โœ… Separate API keys per environment
  258. - โœ… Production keys isolated from development
  259. - โœ… Instance validation before API calls
  260. ### Safe Operations
  261. ```
  262. โš ๏ธ IMPORTANT: Be careful with destructive operations!
  263. - Always test in development first
  264. - Use get_workflow to backup before modifications
  265. - Review workflow details before deletion
  266. - Enable debug mode for troubleshooting
  267. ```
  268. ---
  269. ## ๐Ÿ› Troubleshooting
  270. ### Common Issues
  271. <details>
  272. <summary><b>MCP Server Connection Fails</b></summary>
  273. **Symptoms:** Claude/Cursor can't find n8n tools
  274. **Solutions:**
  275. 1. Restart Claude Desktop / Cursor IDE
  276. 2. Check `claude_desktop_config.json` / `.cursor/mcp.json` syntax
  277. 3. Verify n8n instance is accessible
  278. 4. Enable debug mode: `DEBUG=true` in environment
  279. [Full Debug Guide](https://salacoste.github.io/mcp-n8n-workflow-builder/troubleshooting/debug-mode/)
  280. </details>
  281. <details>
  282. <summary><b>404 Errors When Calling n8n API</b></summary>
  283. **Symptoms:** "Request failed with status code 404"
  284. **Solutions:**
  285. 1. Verify `n8n_host` uses base URL (e.g., `https://n8n.example.com`)
  286. 2. Do NOT include `/api/v1` suffix (server adds it automatically)
  287. 3. Check n8n API key has correct permissions
  288. 4. Test connectivity: `curl https://your-n8n-instance.com/api/v1/workflows`
  289. [Configuration Guide](https://salacoste.github.io/mcp-n8n-workflow-builder/getting-started/installation/configuration/)
  290. </details>
  291. <details>
  292. <summary><b>Workflow Activation Fails</b></summary>
  293. **Symptoms:** "Workflow cannot be activated without valid trigger"
  294. **Solutions:**
  295. 1. Ensure workflow has at least one trigger node (webhook, schedule, etc.)
  296. 2. `manualTrigger` is NOT recognized by n8n API v1.82.3
  297. 3. Server automatically adds valid triggers if missing
  298. [Error Reference](https://salacoste.github.io/mcp-n8n-workflow-builder/troubleshooting/error-reference/)
  299. </details>
  300. ### Get Help
  301. - ๐Ÿ“š [Full Troubleshooting Guide](https://salacoste.github.io/mcp-n8n-workflow-builder/troubleshooting/faq/)
  302. - ๐Ÿ› [Report Issues](https://github.com/salacoste/mcp-n8n-workflow-builder/issues)
  303. - ๐Ÿ’ฌ [GitHub Discussions](https://github.com/salacoste/mcp-n8n-workflow-builder/discussions)
  304. ---
  305. ## ๐Ÿ“Š What's New
  306. ### Version 0.9.3 (Latest) - Security & Documentation
  307. - ๐Ÿ”’ **Security Fix:** Prevented log files from being published to npm
  308. - ๐Ÿ“ฆ **Package Optimization:** Reduced size to 653KB (from 699KB)
  309. - ๐Ÿ“š **Documentation Enhancement:** Added badges and improved npm metadata
  310. - โœ… **API Key Rotation:** Updated security practices
  311. ### Version 0.9.0 - MCP Protocol Compliance
  312. - โœ… **Full MCP notification handler support**
  313. - โœ… **Fixed** "Method 'notifications/initialized' not found" error
  314. - ๐Ÿ“ฆ **Package size optimization:** 1.3MB โ†’ 278KB
  315. - ๐Ÿ—๏ธ **Multi-instance architecture** with intelligent routing
  316. - ๐Ÿ” **Enhanced credential management** with schema validation
  317. ### Epic 2 Complete (13/13 Stories) - Advanced API Implementation
  318. - โœ… **17 MCP Tools** implemented (8 workflows + 4 executions + 5 tags + 6 credentials)
  319. - โœ… **100% test success rate** across all implementations
  320. - โœ… **12,000+ lines of documentation** with comprehensive examples
  321. - โœ… **Production-ready quality** with zero bugs
  322. [View Full Changelog](https://salacoste.github.io/mcp-n8n-workflow-builder/about/changelog/)
  323. ---
  324. ## ๐Ÿ—บ๏ธ Roadmap
  325. ### โœ… Completed
  326. - [x] Core workflow CRUD operations
  327. - [x] Execution management and monitoring
  328. - [x] Tag-based workflow organization
  329. - [x] Multi-instance architecture
  330. - [x] Credential lifecycle management
  331. - [x] Comprehensive documentation site (38+ pages)
  332. - [x] GitHub Pages deployment with CI/CD
  333. ### ๐Ÿšง In Progress
  334. - [ ] Workflow templates library
  335. - [ ] Enhanced error recovery patterns
  336. - [ ] Performance optimization for large workflows
  337. - [ ] Advanced filtering and search capabilities
  338. ### ๐Ÿ”ฎ Planned
  339. - [ ] Visual workflow editor integration
  340. - [ ] Workflow version control and rollback
  341. - [ ] Collaborative workflow development
  342. - [ ] Advanced analytics and insights
  343. - [ ] Workflow marketplace and sharing
  344. [Suggest a Feature](https://github.com/salacoste/mcp-n8n-workflow-builder/issues/new)
  345. ---
  346. ## ๐Ÿค Contributing
  347. We welcome contributions! Here's how you can help:
  348. ### Ways to Contribute
  349. - ๐Ÿ› **Report Bugs:** [Create an issue](https://github.com/salacoste/mcp-n8n-workflow-builder/issues)
  350. - ๐Ÿ’ก **Suggest Features:** [Open a discussion](https://github.com/salacoste/mcp-n8n-workflow-builder/discussions)
  351. - ๐Ÿ“– **Improve Documentation:** Submit documentation improvements
  352. - ๐Ÿ”ง **Submit Pull Requests:** Fix bugs or add features
  353. ### Development Setup
  354. ```bash
  355. # Clone repository
  356. git clone https://github.com/salacoste/mcp-n8n-workflow-builder.git
  357. cd mcp-n8n-workflow-builder
  358. # Install dependencies
  359. npm install
  360. # Build project
  361. npm run build
  362. # Run tests
  363. npm test
  364. # Start development server
  365. npm run dev
  366. ```
  367. ### Code Standards
  368. - โœ… TypeScript for type safety
  369. - โœ… ESLint for code quality
  370. - โœ… Prettier for formatting
  371. - โœ… Jest for testing
  372. - โœ… Conventional commits
  373. [Contributing Guide](https://salacoste.github.io/mcp-n8n-workflow-builder/about/contributing/)
  374. ---
  375. ## ๐Ÿ“„ License
  376. This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
  377. ### What This Means
  378. - โœ… **Commercial use** allowed
  379. - โœ… **Modification** allowed
  380. - โœ… **Distribution** allowed
  381. - โœ… **Private use** allowed
  382. - โš ๏ธ **No warranty** provided
  383. - โš ๏ธ **No liability** assumed
  384. [Full License Details](https://salacoste.github.io/mcp-n8n-workflow-builder/about/license/)
  385. ---
  386. ## ๐Ÿ™ Acknowledgments
  387. Built with:
  388. - ๐Ÿค– **[Claude AI](https://claude.ai/)** - AI-powered development assistance
  389. - ๐Ÿ”ง **[n8n](https://n8n.io/)** - Workflow automation platform
  390. - ๐Ÿ”Œ **[Model Context Protocol](https://modelcontextprotocol.io/)** - AI integration standard
  391. - ๐Ÿ“ **[TypeScript](https://www.typescriptlang.org/)** - Type-safe development
  392. - ๐Ÿ“š **[MkDocs Material](https://squidfunk.github.io/mkdocs-material/)** - Documentation framework
  393. Special thanks to:
  394. - The n8n team for building an amazing automation platform
  395. - The Anthropic team for Claude AI and MCP
  396. - All contributors and users providing feedback
  397. ---
  398. ## ๐Ÿ“ž Get in Touch
  399. - ๐ŸŒ **Documentation:** https://salacoste.github.io/mcp-n8n-workflow-builder/
  400. - ๐Ÿ“ฆ **npm Package:** https://www.npmjs.com/package/@kernel.salacoste/n8n-workflow-builder
  401. - ๐Ÿ’ป **GitHub:** https://github.com/salacoste/mcp-n8n-workflow-builder
  402. - ๐Ÿ› **Issues:** https://github.com/salacoste/mcp-n8n-workflow-builder/issues
  403. - ๐Ÿ’ฌ **Discussions:** https://github.com/salacoste/mcp-n8n-workflow-builder/discussions
  404. ---
  405. <div align="center">
  406. **[โฌ† Back to Top](#n8n-workflow-builder-mcp-server)**
  407. Made with โค๏ธ using Claude AI
  408. **โญ If you find this useful, please star the repo!**
  409. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.