n8n-as-code — AI Agent Superpowers for n8n

What it is

n8n-as-code is a plugin that gives AI coding agents access to n8n's entire workflow automation ecosystem. It provides 537 node schemas (one for each n8n integration), 7,700+ workflow templates, and TypeScript definitions for building n8n workflows programmatically. The plugin works with Claude Code, Cursor, VS Code, and other AI coding tools.

n8n-as-code is designed for developers who use n8n for automation and want their AI agent to build, modify, and debug n8n workflows without switching to the n8n GUI.

How it saves time or tokens

Building n8n workflows in the GUI requires clicking through nodes, configuring fields, and connecting triggers manually. n8n-as-code lets your AI agent generate complete workflow definitions in TypeScript or JSON from natural language descriptions. The agent has access to all 537 node schemas, so it knows the exact fields, options, and connections each node supports. A workflow that takes 30 minutes to build in the GUI can be generated in seconds.

How to use

1. Install for Claude Code:

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

1. For VS Code or Cursor, install 'n8n-as-code' from the VS Code Marketplace.

1. Ask your AI agent to build a workflow:

Create an n8n workflow that:
1. Triggers on a webhook POST to /new-lead
2. Sends a Slack notification to #sales
3. Creates a HubSpot contact
4. Sends a welcome email via SendGrid

Example

A generated n8n workflow definition:

import { IWorkflowDefinition } from 'n8n-as-code';

const workflow: IWorkflowDefinition = {
  name: 'New Lead Pipeline',
  nodes: [
    {
      type: 'n8n-nodes-base.webhook',
      parameters: { path: 'new-lead', httpMethod: 'POST' },
      position: [250, 300],
    },
    {
      type: 'n8n-nodes-base.slack',
      parameters: {
        channel: '#sales',
        text: 'New lead: {{$json.name}} ({{$json.email}})',
      },
      position: [450, 200],
    },
    {
      type: 'n8n-nodes-base.hubspot',
      parameters: {
        operation: 'create',
        email: '={{$json.email}}',
        firstName: '={{$json.name}}',
      },
      position: [450, 400],
    },
  ],
  connections: { /* ... */ },
};

Related on TokRepo

• Automation tools — Browse workflow automation tools
• No-code tools — Explore low-code and no-code platforms

Common pitfalls

• Not having n8n credentials configured for the nodes you use. The generated workflow definition is correct, but it needs credentials set up in your n8n instance for each service (Slack, HubSpot, etc.).
• Generating workflows without testing them. Always import the generated workflow into n8n and test with sample data before connecting to production services.
• Using outdated node schemas. Update the n8n-as-code plugin regularly to get the latest node definitions that match your n8n version.