v1.5.0 — Full node catalog with real schemas, autofix, deep debugging, health, backup and HTTP mode

Highlights

Full node catalog — 560 nodes with real schemas. The catalog is now generated directly from the official n8n-nodes-base and @n8n/n8n-nodes-langchain packages: every node ships with its real parameters (types, allowed options, display conditions), credentials, and latest typeVersion. It travels compressed inside the package (~220 KB) and is regenerated weekly by CI. Curated notes, docs links and examples remain as an overlay for the most used nodes.

Schema-aware validation + expression linting. n8n_validate_workflow now catches nonexistent node types, missing required parameters (including conditionally required ones based on the node's actual configuration), invalid option values, and out-of-range typeVersions. It also lints expressions: {{ }} without the = prefix and references to nodes that don't exist in the workflow.

Automatic repair. n8n_autofix_workflow applies safe mechanical fixes — missing typeVersion/positions, duplicate node names (with connection rewiring), connections to nonexistent nodes, and missing = expression prefixes. Preview by default; apply=true saves after taking a snapshot.

Deep debugging & health.

• n8n_get_node_execution_data: see exactly what data flowed through one node of an execution (status, item counts, output samples, error details) without downloading the whole execution.
• n8n_workflow_health: success rate, failures, average duration and last failure per workflow, computed from recent executions and sorted worst-first.

Safety net completed.

• n8n_diff_workflow_snapshot: compare a snapshot against the current state before deciding to roll back.
• n8n_export_all_workflows / n8n_import_workflows: full-instance backup to local JSON files and restore.

Remote HTTP mode. Set N8N_MCP_HTTP_PORT to serve the MCP protocol over streamable HTTP (with a GET /health endpoint and optional bearer auth via N8N_MCP_HTTP_TOKEN) — run it in Docker or on a VPS and share it across clients.

61 tools (core,builder exposes 28) + 2 guided prompts. 44 unit tests.

v1.4.1 - Official MCP Registry support

Adds server.json and the mcpName field so the server is discoverable through the Official MCP Registry (and the directories that index it, like PulseMCP). Registry publication is now automated in CI after each npm release. No functional changes.

v1.4.0 - Snapshots & rollback, real webhook testing, guided prompts

Highlights

• Automatic snapshots + rollback: before every update, partial edit, or delete, the previous state of the workflow is saved locally. n8n_rollback_workflow restores any version — and can even recreate a deleted workflow. Agents can now edit workflows without fear.
• Real end-to-end testing: n8n_trigger_webhook calls a Webhook-trigger workflow on your instance and returns the actual HTTP response, closing the build → test → fix loop.
• Guided MCP prompts: build-workflow and fix-workflow walk any MCP client through the full validated build and repair process.
• Node catalog x3: from 19 to ~60 curated nodes — more triggers, data utilities, databases (Postgres, MySQL, MongoDB, Redis, Supabase, Airtable, Notion, S3), Google/Microsoft, messaging (Discord, WhatsApp, Twilio, Teams), business apps (GitHub, Jira, HubSpot, Stripe, Shopify), and LangChain AI sub-nodes.
• Docker support: ship the server as a container with persistent snapshot storage.
• Automated releases: publishing a GitHub release now publishes to npm with provenance via CI.

55 tools, 2 prompts. See the CHANGELOG for details.

v1.3.0

Operate the instance and build workflows from the same local MCP.

Added

• Builder tools: n8n_search_nodes, n8n_get_node, n8n_validate_workflow, n8n_update_workflow_partial, n8n_debug_last_error
• Search and import official templates from n8n.io (n8n_search_public_templates, n8n_import_public_template)
• Optional N8N_TOOLSETS (all, or core / builder / admin) so clients can load only what they need

Unchanged

• Full instance administration (users, projects, variables, audit, executions) remains available by default

npm: https://www.npmjs.com/package/mcp-n8n

v1.2.1

Documentation refinements in the changelog and test descriptions. No code changes from 1.2.0.

v1.2.0

Fixed

• n8n_update_workflow now supports partial updates (fetch-and-merge, since the n8n API rejects partial PUT bodies).
• n8n_create_workflow works with just a name: required API fields get sensible defaults.
• Repository URLs in package.json and docs now point to the correct GitHub account.

Changed

• Migrated to the modern McpServer API with per-tool Zod input validation.
• All 45 tools carry MCP annotations (16 read-only, 8 destructive) so clients can gate dangerous operations.
• Cleaned up the bundled workflow templates: leftover configuration values were normalized to generic placeholders.
• Updated all dependencies to their latest versions.
• Requires Node.js >= 20; removed unused dotenv.

Added

• Vitest unit tests covering workflow updates, field filtering, template matching, and template integrity.
• GitHub Actions CI (build, tests, audit on Node 20 and 22).

npm: https://www.npmjs.com/package/mcp-n8n

v1.0.0 - Initial Release

MCP n8n Server v1.0.0

🎉 Initial release of the complete n8n API integration for Claude Desktop and Cursor!

🚀 Features

Core Functionality

• 41 MCP tools for complete n8n management
• Workflow Operations: Full CRUD with activation control
• Execution Monitoring: Track, retry, and manage workflow executions
• Credential Management: Secure credential handling with schema discovery
• Organization Tools: Projects, tags, variables, users, and permissions

🎯 Workflow Templates

• 100 production-ready templates with intelligent matching
• 13 categories: E-commerce, Social Media, AI/Chat, Communication, Content, HR, Sales/CRM, Finance, Data Scraping, Monitoring, Productivity
• Smart selection: AI automatically chooses the best template for your use case

📦 Installation

```bash
npm install -g mcp-n8n
```

🔧 Configuration

Add to Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
"mcpServers": {
"n8n": {
"command": "mcp-n8n",
"env": {
"N8N_BASE_URL": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}
```

📚 Documentation

• Quick Start Guide
• Examples & Use Cases
• Complete Documentation

🔗 Links

• npm: https://www.npmjs.com/package/mcp-n8n
• GitHub: https://github.com/gomakers-ai/mcp-n8n

Made with ❤️ by GoMakers.ai