n8n Manager for AI Agents

by czlonkowski

Not rated
GitHub

About

Manage n8n workflow automation instances through natural language using the n8n public API.

Details

Author
czlonkowski
Categories
Productivity, Other, Automation, API

Setup

Install n8n Manager for AI Agents in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/czlonkowski/n8n-manager-for-ai-agents

Follow the installation instructions in the repository README, then restart your MCP client.

[!IMPORTANT]This repository is no longer being actively developed.The n8n instance management tools have been integrated into the more comprehensiven8n-mcpproject, which provides a complete solution for n8n automation with AI agents.

Please usen8n-mcpfor the latest features and updates.

A Model Context Protocol (MCP) server that enables Claude Desktop and other AI agents to manage n8n workflow automation instances through the n8n API.

This MCP server provides AI agents with tools to manage n8n workflows programmatically. It implements the core n8n API operations with intelligent workarounds for API limitations.

- Workflow Management: Create, read, update, and delete workflows
- Execution Monitoring: List and view execution details, delete execution records
- Webhook Triggers: Execute workflows via webhook endpoints
- Health Monitoring: Check n8n instance connectivity and configuration

- Workflow Activation: Cannot activate/deactivate workflows via API (manual UI activation required)
- Direct Execution: Not available - must use webhook triggers
- Tags & Credentials: Read-only fields, cannot be set via API

- Workflow Operations: Full CRUD operations for n8n workflows
- Execution Management: View, list, and delete execution records
- Webhook-Based Execution: Trigger workflows via webhook URLs
- Smart Error Handling: Automatic removal of read-only fields, method fallbacks
- AI-Friendly Descriptions: Enhanced tool descriptions with examples and clear limitations
- Cursor-Based Pagination: Efficient handling of large result sets
- Health Monitoring: Built-in connectivity and configuration checks

- Workflow Activation: Theactivefield is read-only - workflows must be activated manually in the UI
- Tags Field: Read-only during creation and updates
- PATCH Method: Some n8n instances don't support PATCH for workflow updates
- Direct Execution: Must use webhook triggers (no direct execution API)
- Settings Field: Required but undocumented - we provide sensible defaults

- User Management: No public API endpoints
- Credential Management: Limited API, schemas not exposed
- Stop Execution: Cannot stop running executions via API
- Variables: Only available through source control API
- Import/Export: Planned but not yet implemented

- n8n_create_workflow- Create new workflows with nodes and connections
- n8n_get_workflow- Retrieve workflow details by ID
- n8n_update_workflow- Update existing workflows (requires full node list)
- n8n_delete_workflow- Delete workflows permanently
- n8n_list_workflows- List workflows with filtering and pagination

- n8n_trigger_webhook_workflow- Trigger workflows via webhook URL
- n8n_get_execution- Get detailed execution information
- n8n_list_executions- List executions with status filtering
- n8n_delete_execution- Delete execution records

- n8n_health_check- Check API connectivity and configuration

- Runtime: Node.js 20+
- Language: TypeScript 5.0
- MCP SDK: @modelcontextprotocol/sdk v1.13.1
- HTTP Client: Axios with retry logic
- Validation: Zod schemas
- Logging: Winston (file-based in MCP mode)
- Build: TypeScript with ES modules

- Node.js 20 or higher
- n8n instance with API access enabled
- n8n API key
- Claude Desktop (for MCP integration)

git clone https://github.com/czlonkowski/n8n-manager-for-ai-agents cd n8n-manager-for-ai-agents
cp .env.example .env # Edit .env with your n8n instance details

Configure Claude DesktopAdd to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS):

{ "mcpServers": { "n8n-manager": { "command": "node", "args": ["/absolute/path/to/n8n-manager-for-ai-agents/build/index.js"], "env": { "N8N_API_URL": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key", "LOG_LEVEL": "info", "NODE_ENV": "production", "MCP_MODE": "stdio" } } } }

Restart Claude Desktopand verify the n8n-manager appears in the MCP tools list

Logs are written to~/.n8n-manager/logs/n8n-manager.logto avoid interfering with MCP protocol communication.

"Create a workflow named 'Test API' with a manual trigger"
"Show me all active workflows" "List workflows with tag 'production'"
"Show recent executions for workflow ID abc123" "Get details of execution xyz789"
"Trigger the webhook at https://n8n.example.com/webhook/abc-def-ghi"

- CLAUDE.md- AI guidance, examples, and error solutions
-
Product Requirements Document- Original project specifications
-
Implementation Checklist- Development progress

# Run tests npm test # Run in development mode npm run dev # Type checking npm run typecheck # Linting npm run lint # Build for production npm run build

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

- API keys are stored in environment variables
- No sensitive data is logged
- All communications use HTTPS
- Implements rate limiting and request validation

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

Copyright (c) 2024 Romuald Czlonkowski @aiadvisors.pl

- n8n- The workflow automation platform
-
Anthropic- For Claude and the MCP protocol
-
Model Context Protocol- The protocol enabling this integration

Phase 1 Complete: Core workflow and execution management tools are fully functional. SeeCLAUDE.mdfor detailed usage guidance and common error solutions.

Operate and build n8n: 55 tools with validation, surgical edits, webhook testing and rollback.

An MCP server for managing n8n workflows through its API.

Magica is your all-in-one AI platform, offering 2500+ cutting-edge tools under a single subscription.

Turn your Make scenarios into callable tools for AI assistants.

Dynamically search and call tools using UnifAI Network

WunderTrading MCP connects AI agents to live crypto trading execution on 20+ supported exchanges through a single MCP integration. Use it to turn AI-driven signals, market analysis, sentiment, screenshots, and custom strategy logic into real trades on exchanges including Binance, Bybit, Coinbase, Bitget, OKX, KuCoin, Hyperliquid, and BingX. Supports MCP and REST API workflows for order execution, trade management, and AI-powered automation.

Connect your AI Agents to 8,000 apps instantly.

Connect AI assistants to Automatisch for workflow automation.

Unified MCP gateway that loads 150+ AI tools into Claude Desktop via a single Docker command on Windows. Routes tool calls across specialized servers (Business Intelligence, API Hub, Content Automation, Intelligence) with centralized logging and governance. Built for teams without dedicated platform engineers.

Gherkio lets you describe HTTP-based integration tests as declarative YAML scenarios. Define requests, assertions, variable extractions, and orchestration. all in a simple, human-readable format that stays maintainable over time.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.