Enables workflow automation management through n8n's REST API, providing tools for creating, executing, and monitoring workflows, managing tags and credentials, handling webhook configuration, and accessing execution history.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@n8n MCP Serverlist my active workflows"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Features
π 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
Prerequisites
Node.js 18 or higher
n8n instance with API access enabled
n8n API key
Installation
From npm (when published)
From source
Configuration
Getting your n8n API Key
Log in to your n8n instance
Go to Settings β API
Generate an API key
Configure Claude Desktop
Add the following to your Claude Desktop configuration (claude_desktop_config.json):
For n8n cloud instances, use:
N8N_URL:https://your-subdomain.app.n8n.cloud
Available Tools
Workflow Management
list_workflows- List all workflows with optional filteringget_workflow- Get detailed information about a specific workflowcreate_workflow- Create a new workflow from JSONupdate_workflow- Update an existing workflowdelete_workflow- Delete a workflowactivate_workflow- Activate a workflowdeactivate_workflow- Deactivate a workflow
Execution
execute_workflow- Execute a workflow with optional input dataget_executions- Get execution history with filtering optionsget_execution- Get details of a specific executiondelete_execution- Delete an executionretry_execution- Retry a failed execution
Tags
get_tags- List all available tagscreate_tag- Create a new tagupdate_tag- Update a tagdelete_tag- Delete a tag
Other
get_credentials- List available credentials (names only)search_workflows- Search workflows by name or tagsget_workflow_webhooks- Get webhook URLs for a workflow
Usage Examples
List all active workflows
Execute a workflow
Create a new workflow
Development
Setup
Build
Test locally
Run tests
Security Notes
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
Contributing
Contributions are welcome! Please:
Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request
License
MIT - see LICENSE file
Support
π Report bugs
π‘ Request features
π€ MCP Documentation
Author
Michael Nikolaus - GitHub