https://github.com/ifmelate/n8n-workflow-builder-mcp
MCP server that allow LLM in agent mode builds n8n workflows for you
https://github.com/ifmelate/n8n-workflow-builder-mcp
agent ai cursor mcp mcp-server n8n workflow
Last synced: 2 months ago
JSON representation
MCP server that allow LLM in agent mode builds n8n workflows for you
- Host: GitHub
- URL: https://github.com/ifmelate/n8n-workflow-builder-mcp
- Owner: ifmelate
- License: mit
- Created: 2025-05-17T09:47:27.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-07-26T11:18:20.000Z (2 months ago)
- Last Synced: 2025-07-26T15:55:27.060Z (2 months ago)
- Topics: agent, ai, cursor, mcp, mcp-server, n8n, workflow
- Language: JavaScript
- Homepage:
- Size: 1.1 MB
- Stars: 27
- Watchers: 1
- Forks: 7
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **n8n-workflow-builder-mcp** - MCP server that allow LLM in agent mode builds n8n workflows for you `javascript` `agent` `ai` `cursor` `mcp` `npm install ifmelate/n8n-workflow-builder-mcp` (AI/ML)
- awesome-mcp-servers - **n8n-workflow-builder-mcp** - MCP server that allow LLM in agent mode builds n8n workflows for you `javascript` `agent` `ai` `cursor` `mcp` `npm install ifmelate/n8n-workflow-builder-mcp` (AI/ML)
README
# n8n Workflow Builder MCP
This project provides a Model Context Protocol (MCP) server for building and manipulating n8n workflows JSON in Cursor IDE. It's a way to build n8n workflows just by prompting with AI in chat.
# DEMO VIDEO:
[](https://youtu.be/MKEVLM5QmPA?si=8SJQAcYGeAIuhaBm)
## Current status of implementation
It's in early development stage. Basically, it's working - MCP server creates JSON file with n8n workflow that you can copy and paste to workflow editor in n8n UI.
Current problems:
- sometimes llm agents put wrong parameters in the request. **I plan to find a way to fix this**.
- sometimes connection between nodes is not setting. **I'm working to resolve it**.
- not all types of node are checked working. **I'm working to resolve it**.
- initial prompt does matter. If it's not clear, the agent will go wrong way. **I plan to find a way to fix this**.
## Key Features
- **Workflow Management**: Create, update, and execute n8n workflows programmatically (execute is not implemented yet)
- **Node Discovery**: Explore available n8n nodes and their capabilities
- **Connection Management**: Create connections between workflow nodes
- **AI Integration**: Special tools for connecting AI components in workflows
- **AI-Friendly Interface**: Designed specifically for interaction with AI agents
## Prerequisites
- Node.js (v14 or higher)
- Cursor IDE (v0.48 or newer)
- npm (for npx command)
## Installation & Setup
### Recommended: Using npx in mcp.json (Easiest)
The recommended way to install this MCP server is using npx directly in your `.cursor/mcp.json` file:
```json
{
"mcpServers": {
"n8n-workflow-builder": {
"command": "npx",
"args": [
"-y",
"n8n-workflow-builder-mcp"
],
"env": {
"N8N_API_URL": "http://localhost:5678",
"N8N_API_KEY": "your-n8n-api-key-here"
}
}
}
}
```
This approach:
- ✅ Automatically installs the latest version
- ✅ Does not require global installation
- ✅ Works reliably across different environments
- ✅ No manual building or path configuration needed
**Setup Steps:**
1. Create the `.cursor` directory in your project root (if it doesn't exist):
```bash
mkdir -p .cursor
```
3. Create or update `.cursor/mcp.json` with the configuration above, replacing:
- `N8N_API_URL`: Your n8n instance URL (default: `http://localhost:5678`)
- `N8N_API_KEY`: Your n8n API key from the n8n settings
4. Restart Cursor IDE for changes to take effect
### Getting your n8n API Key:
1. Open your n8n instance in a browser
2. Go to Settings > API Keys
3. Click "Create API Key"
4. Copy the generated key and use it in your configuration
### Alternative: Development Installation
For development or local testing, you can clone and build from source:
1. Clone the repository:
```bash
git clone https://github.com/ifmelate/n8n-workflow-builder-mcp.git
cd n8n-workflow-builder-mcp
```
2. Install dependencies:
```bash
npm install
```
3. Build the TypeScript project:
```bash
npm run build
```
4. Configure in `.cursor/mcp.json`:
```json
{
"mcpServers": {
"n8n-workflow-builder": {
"command": "node",
"args": ["/absolute/path/to/n8n-workflow-builder-mcp/dist/index.js"],
"env": {
"N8N_API_URL": "http://localhost:5678",
"N8N_API_KEY": "your-n8n-api-key-here"
}
}
}
}
```
5. For development with auto-rebuild:
```bash
npm run dev
```
## Cursor IDE Integration
### Using Cursor Settings UI (Optional)
Alternatively, you can set up the MCP server through Cursor's interface:
1. Start Cursor IDE
2. Go to Settings > Features > MCP Servers
3. Click "Add Server"
4. For npx method: Use command `npx` with args `["-y", "n8n-workflow-builder-mcp"]`
5. Add environment variables:
- `N8N_API_URL`: `http://localhost:5678`
- `N8N_API_KEY`: `your-n8n-api-key-here`
6. Make sure the server is enabled
7. Restart Cursor IDE for changes to take effect
## Available MCP Tools
The server provides the following tools for working with n8n workflows:
| Tool Name | Description | Key Parameters |
|-----------|-------------|----------------|
| **create_workflow** | Create a new n8n workflow | `workflow_name`, `workspace_dir` |
| **list_workflows** | List all existing workflows | (no parameters) |
| **get_workflow_details** | Get detailed information about a specific workflow | `workflow_name`, `workflow_path` (optional) |
| **add_node** | Add a new node to a workflow | `workflow_name`, `node_type`, `position`, `parameters`, `node_name`, `typeVersion`, `webhookId`, `workflow_path` (optional) |
| **edit_node** | Edit an existing node in a workflow | `workflow_name`, `node_id`, `node_type`, `node_name`, `position`, `parameters`, `typeVersion`, `webhookId`, `workflow_path` (optional) |
| **delete_node** | Delete a node from a workflow | `workflow_name`, `node_id`, `workflow_path` (optional) |
| **add_connection** | Add a connection between nodes | `workflow_name`, `source_node_id`, `source_node_output_name`, `target_node_id`, `target_node_input_name`, `target_node_input_index` |
| **add_ai_connections** | Add AI connections for LangChain nodes | `workflow_name`, `agent_node_id`, `model_node_id`, `tool_node_ids`, `memory_node_id` |
| **list_available_nodes** | List available node types with optional filtering | `search_term` (optional) |
## Troubleshooting Cursor Integration
If you're having trouble getting the MCP server to work with Cursor, try these steps:
### For npx installation (Recommended method):
Make sure your `.cursor/mcp.json` file is properly formatted:
```json
{
"mcpServers": {
"n8n-workflow-builder": {
"command": "npx",
"args": ["-y", "n8n-workflow-builder-mcp"]
}
}
}
```
### General troubleshooting:
1. **Check Cursor MCP settings**:
- Open Cursor Settings
- Go to Features > MCP Servers
- Make sure your server is listed and enabled
- If it's listed but not working, try clicking the refresh button
2. **Check server logs**: Look for errors in the Cursor Output panel. Select "Cursor MCP" from the dropdown in the Output panel to see MCP-specific logs.
3. **Try manual installation**: If npx fails, try the global installation method as an alternative:
```bash
npm install -g n8n-workflow-builder-mcp
```
## Common Issues and Solutions
### "Failed to create client" or "Module not found"
This usually happens when:
- Internet connection issues prevent npx from downloading the package
- Node.js/npm version compatibility issues
- Cursor MCP service is not running properly
Try:
1. Check your internet connection
2. Update Node.js to the latest LTS version
3. Restart Cursor completely
4. Try the global installation method as fallback
### MCP Server is not showing up in Cursor
This can happen if:
- The `.cursor/mcp.json` file is not properly formatted
- Cursor hasn't detected the configuration change
- File permissions on the `.cursor` directory
Try:
1. Validating the JSON format of your `.cursor/mcp.json` file
2. Restarting Cursor
3. Manually selecting the server in Cursor settings (if it appears there)
4. Check file permissions: `chmod 755 .cursor`
### MCP Server shows up but tools aren't available
This can happen if:
- The server isn't properly registering its tools
- Package installation is incomplete
- Version compatibility issues
Try:
1. Check the package was downloaded correctly by npx
2. Clicking the refresh button in the MCP server settings in Cursor
3. Try clearing npm cache: `npm cache clean --force`
4. Use the development installation method for debugging
## Project Structure
- `/src`: Main source code
- `/src/tools`: MCP tools implementation
- `/src/models`: Data models
- `/src/utils`: Utility functions
- `/src/middleware`: Authentication and middleware
- `/config`: Configuration files
- `/tests`: Test files
- `/workflow_nodes`: n8n node definitions
- `/docs`: Additional documentation
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## License
MIT License