Cursor n8n MCP Server

License: MIT Node.js Version

A Model Context Protocol (MCP) server that enables AI assistants in Cursor IDE to manage n8n workflows through the n8n REST API.

Features

Workflow Management: Create, update, delete, and list workflows
Workflow Activation: Activate and deactivate workflows
Execution Management: View execution history and details
Webhook Triggering: Trigger workflows via webhook URLs
Self-Documentation: Built-in help system for AI assistants
Node Information: Common n8n node types and configurations
Error Handling: Automatic retry with exponential backoff

Quick Start

Installation

git clone https://github.com/alicankiraz1/cursor-n8n-mcp.git cd cursor-n8n-mcp npm install npm run build node dist/index.js setup

Or use the install script:

./install.sh

Manual Configuration

Create or edit ~/.cursor/mcp.json for global configuration:

{ "mcpServers": { "cursor-n8n-mcp": { "command": "node", "args": ["/path/to/cursor-n8n-mcp/dist/index.js"], "env": { "MCP_MODE": "stdio", "LOG_LEVEL": "error", "N8N_API_URL": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key" } } } }

Getting n8n API Key

Log in to your n8n instance
Go to Settings > API
Click Create API Key
Copy the generated key

Available Tools

Documentation & Help

Tool	Description
`n8n_tools_help`	Get usage guide and documentation
`n8n_get_node_info`	Get information about common n8n nodes

Workflow Management

Tool	Description
`n8n_list_workflows`	List all workflows
`n8n_get_workflow`	Get workflow details by ID
`n8n_create_workflow`	Create a new workflow
`n8n_update_workflow`	Update an existing workflow
`n8n_delete_workflow`	Delete a workflow
`n8n_activate_workflow`	Activate a workflow
`n8n_deactivate_workflow`	Deactivate a workflow

Execution Management

Tool	Description
`n8n_list_executions`	List execution history
`n8n_get_execution`	Get execution details
`n8n_delete_execution`	Delete an execution record
`n8n_trigger_webhook`	Trigger a workflow via webhook

System

Tool	Description
`n8n_health_check`	Check n8n API connectivity

Usage Examples

Check Connection

"Check the n8n connection"

List Workflows

"List all workflows in n8n"

Create a Workflow

"Create a webhook workflow that responds with the received data"

Get Node Information

"Show me how to configure a webhook node"

CLI Commands

node dist/index.js --help # Show help node dist/index.js setup # Interactive setup node dist/index.js config # Show configuration template

Project Structure

cursor-n8n-mcp/ ├── src/ │ ├── index.ts # Entry point with CLI │ ├── server.ts # MCP Server implementation │ ├── tools/ │ │ ├── index.ts # Tool exports │ │ ├── workflow-tools.ts # Workflow CRUD operations │ │ ├── execution-tools.ts# Execution management │ │ └── documentation-tools.ts # Help and node info │ ├── services/ │ │ └── n8n-api-client.ts # n8n REST API client │ ├── types/ │ │ └── index.ts # TypeScript definitions │ └── utils/ │ ├── logger.ts # Logging utility │ └── errors.ts # Error handling ├── package.json ├── tsconfig.json ├── LICENSE └── README.md

Supported Node Types

The n8n_get_node_info tool provides information about these common nodes:

Triggers: webhook, scheduleTrigger, manualTrigger
Actions: httpRequest, code, set, if, merge
Utilities: splitInBatches, respondToWebhook

Error Handling

The server includes robust error handling:

Automatic Retry: Failed requests are retried up to 3 times
Exponential Backoff: Delays increase between retries
Detailed Errors: Error messages include hints for resolution
Timeout Management: 30-second timeout for API requests

Environment Variables

Variable	Description	Required
`N8N_API_URL`	Your n8n instance URL	Yes
`N8N_API_KEY`	n8n API key	Yes
`LOG_LEVEL`	Log level (debug, info, warn, error)	No
`MCP_MODE`	MCP transport mode (stdio)	No

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

n8n - Workflow automation platform
Anthropic - Model Context Protocol
Cursor - AI-powered IDE

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Cursor n8n Builder