n8n MCP Server

MCP (Model Context Protocol) server for n8n workflow automation. This server enables AI assistants like Claude to interact with n8n instances via the REST API.

- 🔄Workflow Management: List, create, update, and delete workflows
- ▶️Execution Control: Execute workflows and monitor executions
- 🏷️Tag Management: Organize workflows with tags
- 📊Execution History: Access workflow execution history and results
- 🔑Credential Management: List available credentials (read-only)
- 🌐Webhook Management: Create and manage webhooks
- 🔍Search: Search workflows by name or tags

- Node.js 18 or higher
- n8n instance with API access enabled
- n8n API key

git clone https://github.com/nikolausm/n8n-mcp-server.git cd n8n-mcp-server npm install npm run build

- Log in to your n8n instance
- Go to Settings → API
- Generate an API key

Add the following to your Claude Desktop configuration (claude_desktop_config.json):

{ "mcpServers": { "n8n": { "command": "node", "args": ["/path/to/n8n-mcp-server/dist/index.js"], "env": { "N8N_URL": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key-here" } } } }

- N8N_URL:https://your-subdomain.app.n8n.cloud

- list_workflows- List all workflows with optional filtering
- get_workflow- Get detailed information about a specific workflow
- create_workflow- Create a new workflow from JSON
- update_workflow- Update an existing workflow
- delete_workflow- Delete a workflow
- activate_workflow- Activate a workflow
- deactivate_workflow- Deactivate a workflow

- execute_workflow- Execute a workflow with optional input data
- get_executions- Get execution history with filtering options
- get_execution- Get details of a specific execution
- delete_execution- Delete an execution
- retry_execution- Retry a failed execution

- get_tags- List all available tags
- create_tag- Create a new tag
- update_tag- Update a tag
- delete_tag- Delete a tag

- get_credentials- List available credentials (names only)
- search_workflows- Search workflows by name or tags
- get_workflow_webhooks- Get webhook URLs for a workflow

Assistant: I'll list all your active n8n workflows. [Uses list_workflows tool with active=true]

Assistant: I'll execute the workflow with the data you provided. [Uses execute_workflow tool with workflowId and data]

Assistant: I'll create a new workflow for you. [Uses create_workflow tool with workflow JSON]

N8N_URL=https://your-instance.com N8N_API_KEY=your-key npm start

- Never commit your API keys
- Use environment variables for sensitive data
- The MCP server has the same permissions as your API key
- Consider using a restricted API key if possible
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request

- 🐛Report bugs
- 💡Request features
- 📖n8n API Documentation
- 🤝MCP Documentation

Automated document processing and extraction