{"_id":"@agent-tools-kiko/n8n-mcp","name":"@agent-tools-kiko/n8n-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@agent-tools-kiko/n8n-mcp","version":"1.0.0","description":"MCP server for n8n — build, deploy, debug and manage workflows with Claude. Supports stdio (Claude Code) and HTTP (Claude Desktop custom connector).","main":"dist/index.js","bin":{"n8n-mcp":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","dev":"tsc --watch","start":"node dist/index.js","start:http":"MCP_TRANSPORT=http node dist/index.js","prepublishOnly":"npm run build"},"keywords":["mcp","n8n","automation","workflow","claude","ai-agent","model-context-protocol","llm-tools"],"author":{"name":"Enrico Buffara"},"license":"MIT","homepage":"https://github.com/Kikobuf/agent-tools/tree/main/packages/n8n-mcp","repository":{"type":"git","url":"git+https://github.com/Kikobuf/agent-tools.git","directory":"packages/n8n-mcp"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":">=1.10.0","axios":"^1.6.0","zod":"^3.22.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0"},"gitHead":"125c6b6493166443a79a3f5dcf3534cddc26465b","_id":"@agent-tools-kiko/n8n-mcp@1.0.0","bugs":{"url":"https://github.com/Kikobuf/agent-tools/issues"},"_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-O/oXiH6L9ASCJs3/wNZEs3aPCizDb1FxiWPZnn9Hp3gv+iLNoiqoCc37FoQtEaxFm8MDJWU4B+eV3huZKvw8XA==","shasum":"24ebb3bbc3271f47123ad4e9c24b8c2938c18a3b","tarball":"https://registry.npmjs.org/@agent-tools-kiko/n8n-mcp/-/n8n-mcp-1.0.0.tgz","fileCount":7,"unpackedSize":36210,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDJ8GnzzgJ22wt7a5Gkd3wrgXECYBel4HKsoNIRZSc8bQIhAIxP4PqugokmzGSsg/PwWX/sAXBsiTT/TP2+sCB+2t7p"}]},"_npmUser":{"name":"kikobuf","email":"enricobuffara@icloud.com"},"directories":{},"maintainers":[{"name":"kikobuf","email":"enricobuffara@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-mcp_1.0.0_1781048741148_0.29008351819762757"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-09T23:45:41.002Z","1.0.0":"2026-06-09T23:45:41.297Z","modified":"2026-06-09T23:45:41.523Z"},"maintainers":[{"name":"kikobuf","email":"enricobuffara@icloud.com"}],"description":"MCP server for n8n — build, deploy, debug and manage workflows with Claude. Supports stdio (Claude Code) and HTTP (Claude Desktop custom connector).","homepage":"https://github.com/Kikobuf/agent-tools/tree/main/packages/n8n-mcp","keywords":["mcp","n8n","automation","workflow","claude","ai-agent","model-context-protocol","llm-tools"],"repository":{"type":"git","url":"git+https://github.com/Kikobuf/agent-tools.git","directory":"packages/n8n-mcp"},"author":{"name":"Enrico Buffara"},"bugs":{"url":"https://github.com/Kikobuf/agent-tools/issues"},"license":"MIT","readme":"# @agent-tools/n8n-mcp\n\n**Your AI automation engineer.** Describe what you want to automate. Claude builds, deploys, and debugs your n8n workflows.\n\n```\n\"Build me a workflow that monitors my Supabase waitlist table and\n sends me a Slack DM when signups exceed 100\"\n```\n\n→ Claude fetches your node schemas, builds the workflow JSON, pushes it to n8n, activates it. No clipboard, no JSON editing, no context switching.\n\n---\n\n## What it does\n\n| Tool | Description |\n|---|---|\n| `list_workflows` | List all workflows with status |\n| `get_workflow` | Get full workflow definition |\n| `explain_workflow` | Plain-English explanation of any workflow |\n| `create_workflow` | Build and push a new workflow |\n| `update_workflow` | Patch nodes/connections on existing workflow |\n| `delete_workflow` | Delete a workflow |\n| `activate_workflow` | Enable a workflow |\n| `deactivate_workflow` | Disable a workflow |\n| `trigger_webhook` | Fire a webhook-based workflow |\n| `list_executions` | Recent runs with status filter |\n| `get_execution` | Full execution data |\n| `debug_execution` | AI-powered failure analysis in plain English |\n| `delete_execution` | Clean up execution history |\n| `list_node_types` | All nodes available on your instance |\n| `get_node_schema` | Exact parameter shape for any node (used before building) |\n| `list_credentials` | Available credentials (names only, no secrets) |\n| `list_tags` | All workflow tags |\n| `list_variables` | n8n environment variables |\n| `switch_instance` | Switch between multiple n8n instances |\n| `list_instances` | Show all configured instances |\n\n---\n\n## Install\n\n### Claude Code\n\n```bash\nclaude mcp add n8n-mcp \\\n  -e N8N_BASE_URL=http://localhost:5678 \\\n  -e N8N_API_KEY=your-api-key \\\n  -- npx @agent-tools/n8n-mcp\n```\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"n8n\": {\n      \"command\": \"npx\",\n      \"args\": [\"@agent-tools/n8n-mcp\"],\n      \"env\": {\n        \"N8N_BASE_URL\": \"http://localhost:5678\",\n        \"N8N_API_KEY\": \"your-n8n-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Get your n8n API key\n\nn8n Settings → API → Create API Key\n\n---\n\n## Multiple instances\n\nPerfect for agencies managing n8n for multiple clients, or running separate prod/staging environments.\n\n```json\n{\n  \"env\": {\n    \"N8N_BASE_URL\": \"http://localhost:5678\",\n    \"N8N_API_KEY\": \"local-key\",\n    \"N8N_INSTANCE_PROD_URL\": \"https://n8n.yourcompany.com\",\n    \"N8N_INSTANCE_PROD_KEY\": \"prod-key\",\n    \"N8N_INSTANCE_STAGING_URL\": \"https://n8n-staging.yourcompany.com\",\n    \"N8N_INSTANCE_STAGING_KEY\": \"staging-key\"\n  }\n}\n```\n\nThen just ask: *\"Switch to prod and list all active workflows\"*\n\n---\n\n## Schema-aware workflow generation\n\nUnlike naive approaches that hallucinate node parameters, `n8n-mcp` fetches the live schema from **your** n8n instance before building a workflow. This means:\n\n- Correct parameter names for your exact n8n version\n- Only uses nodes that are actually installed\n- References real credential names from your instance\n\nClaude automatically calls `get_node_schema` before `create_workflow`. You don't have to do anything.\n\n---\n\n## Dry run mode\n\nNot sure what Claude is about to create? Use dry run:\n\n*\"Build me a Gmail → Notion workflow but don't deploy it yet, just show me what it would do\"*\n\nClaude describes every node, every connection, and the full flow in plain English before touching n8n.\n\n---\n\n## Example prompts\n\n```\nList all my active workflows\n\nWhy did my Slack notification workflow fail last night?\n\nBuild a workflow that:\n- Triggers every day at 9am\n- Fetches my Shopify orders from the last 24 hours\n- Sends a summary to my Telegram\n\nExplain what the \"Customer Onboarding\" workflow does\n\nPause all active workflows — I'm doing a database migration\n\nSwitch to my staging instance and test the webhook trigger\n```\n\n---\n\n## Requirements\n\n- Node.js 18+\n- n8n instance with API access enabled (Settings → API)\n- n8n API key\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-1605f0960cc742cc60105f3d606db0ca"}