Skip to main content

Claude Plugin

The n8n-as-code plugin turns Claude into an n8n workflow expert. Ask for what you want in plain language — Claude handles node lookup, file editing, and sync behind the scenes.

What You Can Do​

Once installed, just talk to Claude:

  • "Create a workflow that watches Typeform responses and sends them to Slack"
  • "Add a Google Sheets node to the onboarding workflow"
  • "Fix the error in the invoice workflow"
  • "Update the AI agent workflow to use a memory node"

Claude will:

  • Guide you through setup if the workspace isn't initialized yet
  • Pull the current workflow before editing
  • Look up exact node schemas to avoid hallucinated parameters
  • Edit the workflow file safely
  • Push the result back to n8n

You stay at the level of intent. The technical details are handled for you.

Installation​

Two commands in Claude Code:

/plugin marketplace add EtienneLescot/n8n-as-code
/plugin install n8n-as-code@n8nac-marketplace

Then initialize your workspace once:

cd /path/to/your/n8n-project
npx --yes n8nac init
npx --yes n8nac update-ai

Restart Claude Code if needed, then start asking for workflow changes.

note

The official Claude Code marketplace listing is pending review. The install path above uses an alternative marketplace hosted in the GitHub repository — it works the same way.

Claude Desktop (MCP)​

Use the local MCP server to give Claude Desktop access to the n8n knowledge base.

  1. Add the server to your Claude Desktop config (claude_desktop_config.json):

    {
      "mcpServers": {
        "n8n-as-code": {
          "command": "npx",
          "args": ["--yes", "n8nac", "skills", "mcp"],
          "env": {
            "N8N_AS_CODE_PROJECT_DIR": "/absolute/path/to/your/n8n-project"
          }
        }
      }
    }

    N8N_AS_CODE_PROJECT_DIR is optional but recommended — it tells the server where to find your n8nac-config.json.

  2. Initialize your workspace:

    cd /path/to/your/n8n-project
    npx --yes n8nac init
    npx --yes n8nac update-ai

  3. Restart Claude Desktop to reload the MCP server.

The MCP server provides offline tools for node search, schema lookup, community workflow examples, and workflow validation.

Claude API​

For programmatic usage with the skills beta:

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.ANTHROPIC_API_KEY,
});

const response = await client.messages.create({
  model: 'claude-3-7-sonnet-20250219',
  max_tokens: 4096,
  betas: [
    'code-execution-2025-08-25',
    'skills-2025-10-02',
    'files-api-2025-04-14'
  ],
  container: {
    type: 'code_execution_2025_01',
    skills: ['n8n-architect']
  },
  messages: [{
    role: 'user',
    content: 'Create a workflow with an HTTP Request node'
  }]
});

Claude.ai (Web)​

Upload the skill manually:

  1. Go to claude.ai/settings/features
  2. Find "Custom Skills" → "Upload Skill"
  3. Upload the n8n-architect skill zip (build instructions in Contribution → Claude Adapter)

Multi-Agent Setups (BMAD / GSD)​

If you use Claude Code with planning and coding agent handoffs:

  1. Install the plugin

  2. Initialize the workspace with n8nac init so n8nac-config.json exists

  3. Run n8nac update-ai — this generates AGENTS.md at the project root with all the workflow rules, sync protocol, and node lookup commands

  4. Point any handoff file (e.g. CLAUDE.md) at AGENTS.md:

    # Claude Code Project Instructions

    For any n8n task in this repository:
    1. Read `./AGENTS.md` before planning, coding, or reviewing.
    2. Treat `./AGENTS.md` as mandatory and authoritative.

AGENTS.md is the single source of truth for n8n-as-code behavior. It's regenerated by n8nac update-ai whenever you upgrade or change instances.

How It Works​

User: "Add a Slack notification step to the lead intake workflow"
         ↓
Claude loads the n8n-architect skill
         ↓
Checks if the project is initialized, guides setup if needed
         ↓
Runs: n8nac list / pull / skills search / node-info
         ↓
Edits the local .workflow.ts file with schema-backed config
         ↓
Validates and pushes the workflow back to n8n

Security​

  • Runs 100% locally — no external servers
  • Uses npx to execute n8nac skills commands
  • Open-source and auditable
  • See Privacy Policy for the full data handling details