Skip to main content

Claude Plugin

The n8n-as-code plugin gives Claude the same workflow model as the CLI and VS Code extension: workspace environments through n8nac env, workspace maintenance through n8nac workspace, and local managed instances through n8n-manager.

Install​

/plugin marketplace add https://github.com/EtienneLescot/n8n-as-code
/plugin install n8n-as-code@n8nac-marketplace

Use the full HTTPS URL because the owner/repo shorthand can trigger SSH cloning.

For prerelease testing:

/plugin marketplace add https://github.com/EtienneLescot/n8n-as-code#next
/plugin install n8n-as-code@n8nac-marketplace

Manual prerelease commands should use matching npm tags:

npx --yes n8nac@next env list
npx --yes @n8n-as-code/n8n-manager@next instance list

Initialize A Workspace​

Ask Claude to initialize n8n-as-code in the workspace. The installed skills guide it through:

  • creating or selecting an n8n environment
  • storing remote API keys locally
  • optionally configuring native n8n MCP live assist for that environment
  • creating or selecting local managed instances when needed
  • generating AGENTS.md
  • materializing .agents/skills/n8n-architect

Manual equivalent:

n8nac env add Dev --base-url <url> --workflows-path workflows/dev
n8nac env auth set Dev --api-key-stdin
n8nac native-mcp configure Dev --url <native-mcp-url> --token-stdin # optional live assist
n8nac env use Dev
n8nac update-ai

Claude Code does not need a manual @n8n-as-code/mcp server configuration. The plugin guides Claude to use n8nac directly in the workspace. If native n8n MCP assist is useful, Claude should propose configuring it on the active environment with n8nac native-mcp configure, then verify it with n8nac native-mcp doctor.

Claude Desktop MCP​

Use the local MCP server for node search, schema lookup, examples, and validation.

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

What Claude Uses​

User asks for a workflow change
Claude reads AGENTS.md and local skills
Claude resolves n8nac env status
Claude pulls or creates workflow files
Claude uses n8n node schemas and docs
Claude uses native MCP live assist only when the configured environment needs live n8n state
Claude edits and validates the workflow
Claude pushes when asked

Security​

  • Skills run locally.
  • Workspace environment config can be committed when it contains no secrets.
  • Remote API keys stay local.
  • Native n8n MCP tokens stay local.
  • Local managed instance state stays in n8n-manager storage.