# n8n MCP Server
A comprehensive MCP (Model Context Protocol) server for n8n workflow automation. This connector provides Claude Desktop with **ALL** available n8n API operations, enabling full workflow management directly from Claude.
## Features
Unlike the limited default connector, this server includes **40+ tools** covering:
### Workflow Management
- `n8n_list_workflows` - List all workflows with filtering
- `n8n_get_workflow` - Get full workflow details including nodes and connections
- `n8n_create_workflow` - Create new workflows with nodes and connections
- `n8n_update_workflow` - Update existing workflows
- `n8n_delete_workflow` - Delete workflows
- `n8n_activate_workflow` - Activate a workflow
- `n8n_deactivate_workflow` - Deactivate a workflow
- `n8n_run_workflow` - Execute a workflow manually
- `n8n_update_workflow_tags` - Update workflow tag associations
- `n8n_duplicate_workflow` - Create a copy of a workflow
- `n8n_export_workflow` - Export workflow as JSON
- `n8n_import_workflow` - Import workflow from JSON
- `n8n_transfer_workflow` - Transfer workflow to another project
### Execution Management
- `n8n_list_executions` - List workflow executions with filtering
- `n8n_get_execution` - Get detailed execution information
- `n8n_delete_execution` - Delete a single execution
- `n8n_delete_executions` - Bulk delete executions
- `n8n_stop_execution` - Stop a running execution
- `n8n_retry_execution` - Retry a failed execution
### Credential Management
- `n8n_list_credentials` - List all credentials
- `n8n_get_credential` - Get credential details
- `n8n_create_credential` - Create new credentials
- `n8n_update_credential` - Update existing credentials
- `n8n_delete_credential` - Delete credentials
- `n8n_get_credential_schema` - Get required fields for credential type
- `n8n_transfer_credential` - Transfer credential to another project
### Tag Management
- `n8n_list_tags` - List all tags
- `n8n_get_tag` - Get tag details
- `n8n_create_tag` - Create new tags
- `n8n_update_tag` - Rename tags
- `n8n_delete_tag` - Delete tags
### Variable Management
- `n8n_list_variables` - List all environment variables
- `n8n_get_variable` - Get variable details
- `n8n_create_variable` - Create new variables
- `n8n_update_variable` - Update variables
- `n8n_delete_variable` - Delete variables
### Project Management
- `n8n_list_projects` - List all projects
- `n8n_get_project` - Get project details
- `n8n_create_project` - Create new projects
- `n8n_update_project` - Rename projects
- `n8n_delete_project` - Delete projects
### User Management
- `n8n_list_users` - List all users
- `n8n_get_user` - Get user details
- `n8n_get_current_user` - Get current authenticated user
### Source Control (Git)
- `n8n_source_control_status` - Get Git status
- `n8n_source_control_pull` - Pull changes from remote
- `n8n_source_control_push` - Push changes to remote
- `n8n_source_control_disconnect` - Disconnect Git integration
### Security & Utilities
- `n8n_check_connection` - Test API connection
- `n8n_generate_audit` - Generate security audit report
- `n8n_get_node_types` - List available node types
- `n8n_get_active_webhooks` - List active webhooks
## Installation
### Prerequisites
- Node.js 18 or later
- n8n instance with API access enabled
- n8n API key (generate in n8n Settings → API)
### Setup
1. **Clone or download this project**:
```bash
git clone git@github.com:DrBalls/n8n-mcp-server-v2.git
cd n8n-mcp-server-v2
```
2. **Install dependencies**:
```bash
npm install
```
3. **Build the project**:
```bash
npm run build
```
4. **Configure Claude Desktop**:
Add to your Claude Desktop configuration file:
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"n8n": {
"command": "node",
"args": ["/absolute/path/to/n8n-mcp-server-v2/dist/index.js"],
"env": {
"N8N_URL": "http://localhost:5678",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}
```
5. **Restart Claude Desktop**
## Configuration
### Environment Variables
| Variable | Description | Default |
|----------|-------------|---------|
| `N8N_URL` | Base URL of your n8n instance | `http://localhost:5678` |
| `N8N_API_KEY` | Your n8n API key | (required) |
### Getting an API Key
1. Open your n8n instance
2. Go to **Settings** → **API**
3. Click **Create API Key**
4. Copy the generated key
## Usage Examples
### Create a Simple Workflow
```
Create a new n8n workflow called "Hello World" with:
1. A manual trigger node
2. A Set node that outputs {"message": "Hello, World!"}
```
### List and Filter Workflows
```
Show me all active workflows tagged with "production"
```
### Run a Workflow with Input
```
Execute workflow ID abc123 with input data: {"email": "test@example.com"}
```
### Manage Credentials
```
List all Slack credentials and show me the schema for creating new ones
```
### Check Execution Status
```
Show me the last 10 failed executions and their error messages
```
### Source Control
```
What's the current Git status? Are there any unpushed changes?
```
## Common Node Types
When creating workflows, use these node type identifiers:
| Node | Type String |
|------|-------------|
| Manual Trigger | `n8n-nodes-base.manualTrigger` |
| Schedule Trigger | `n8n-nodes-base.scheduleTrigger` |
| Webhook | `n8n-nodes-base.webhook` |
| HTTP Request | `n8n-nodes-base.httpRequest` |
| Code (JavaScript) | `n8n-nodes-base.code` |
| Set | `n8n-nodes-base.set` |
| IF | `n8n-nodes-base.if` |
| Switch | `n8n-nodes-base.switch` |
| Merge | `n8n-nodes-base.merge` |
| Split In Batches | `n8n-nodes-base.splitInBatches` |
| Wait | `n8n-nodes-base.wait` |
| No Operation | `n8n-nodes-base.noOp` |
## Troubleshooting
### Connection Failed
- Verify your `N8N_URL` is correct and accessible
- Check that your API key is valid
- Ensure n8n API access is enabled in settings
### Permission Denied
- Your API key may not have sufficient permissions
- Check if the API user has access to the requested resource
### Workflow Not Found
- Verify the workflow ID is correct
- Check if the workflow exists in the specified project
## Development
### Building
```bash
npm run build
```
### Testing Connection
After building, test the connection:
```bash
N8N_URL=http://localhost:5678 N8N_API_KEY=your-key node dist/index.js
```
## License
MIT
## Contributing
Contributions are welcome! Please feel free to submit issues or pull requests.
