n8n CLI Automation

Управляйте своим экземпляром n8n из Claude Code. Работайте с рабочими процессами, учётными данными и выполнениями с помощью навыка n8n-cli для мощной автоматизации.

Продуктивность и workflow ★ 187,122 GitHub (187,122 ★)

Навык n8n-cli позволяет Claude напрямую взаимодействовать с экземплярами n8n, обеспечивая сложную автоматизацию управления жизненным циклом рабочих процессов. Он предоставляет надежный набор инструментов для создания, обновления и мониторинга рабочих процессов, управления конфиденциальными учетными данными через обнаружение схем, обработки повторных попыток выполнения и администрирования проектов и таблиц данных на уровне инстанса. Разработанный для компоновки, этот навык позволяет Claude выполнять сложные административные задачи, миграции между средами и устранение неполадок в реальном времени, что делает его незаменимым инструментом для разработчиков и инженеров по автоматизации, использующих платформу n8n.

Ключевые особенности

01Расширенный мониторинг выполнения с фильтрацией по статусу и автоматической логикой повторных попыток

02Полное управление жизненным циклом рабочих процессов, включая создание, обновление и активацию

03Администрирование инстанса: проекты, теги, переменные и роли пользователей

04Прямые операции с таблицами данных: CRUD и вставка/обновление структурированных данных

05187 122 звезды на GitHub

06Безопасное управление учетными данными с получением метаданных и обнаружением схем

Варианты использования

01Быстрая сборка сложных узлов автоматизации и соединений с помощью JSON-шаблонов

02Программное устранение неполадок и повтор неудачных выполнений на основе конкретных шаблонов ошибок

03Автоматизация развертывания рабочих процессов и резервного копирования между средами staging и production

name	n8n-cli
description	Use the n8n CLI to manage workflows, credentials, executions, and more on an n8n instance. Use when the user asks to interact with n8n, automate workflows, manage credentials, or operate their instance from the command line.
allowed-tools	Bash(n8n-cli:), Bash(echo:), Bash(cat:*), Read, Write

n8n CLI

The n8n-cli command-line tool manages an n8n instance via its REST API. It auto-detects piped output and switches to JSON, making it composable for scripts and LLM tool use.

Setup

# Interactive login (saves to ~/.n8n-cli/config.json)
n8n-cli login

# Or configure directly
n8n-cli config set-url https://my-instance.n8n.cloud
n8n-cli config set-api-key n8n_api_...

# Or use environment variables (no config file needed)
export N8N_URL=https://my-instance.n8n.cloud
export N8N_API_KEY=n8n_api_...

Global Flags

Every command supports these flags:

Flag	Short	Description
`--url`	`-u`	Instance URL (overrides config/env)
`--apiKey`	`-k`	API key (overrides config/env)
`--format`	`-f`	Output format: `table`, `json`, `id-only`
`--json`		Shorthand for `--format=json`
`--jq`		jq-style filter (implies `--json`), e.g. `'.[0].id'`, `'.[].name'`
`--quiet`	`-q`	Suppress output
`--no-header`		Hide table headers (for `awk`/`cut` parsing)
`--debug`		Print HTTP details to stderr

Auto-JSON: When stdout is piped (not a TTY), output defaults to JSON automatically.

Workflows

# List all workflows
n8n-cli workflow list

# Filter workflows
n8n-cli workflow list --active
n8n-cli workflow list --tag=production
n8n-cli workflow list --name="My Workflow"
n8n-cli workflow list --limit=5

# Get a single workflow (full JSON with nodes and connections)
n8n-cli workflow get <id>

# Extract just node names from a workflow
n8n-cli workflow get <id> --jq '.nodes[].name'

# Create a workflow from JSON
n8n-cli workflow create --file=workflow.json
cat workflow.json | n8n-cli workflow create --stdin

# Update a workflow
n8n-cli workflow update <id> --file=updated.json
cat updated.json | n8n-cli workflow update <id> --stdin

# Activate / deactivate
n8n-cli workflow activate <id>
n8n-cli workflow deactivate <id>

# Delete a workflow
n8n-cli workflow delete <id>

# Transfer to another project
n8n-cli workflow transfer <id> --project=<projectId>

# List tags on a workflow
n8n-cli workflow tags <id>

Executions

# List recent executions
n8n-cli execution list
n8n-cli execution list --workflow=<id> --status=error --limit=10
# status options: canceled, error, running, success, waiting

# Get execution details
n8n-cli execution get <id>
n8n-cli execution get <id> --include-data   # includes full node I/O

# Retry a failed execution
n8n-cli execution retry <id>

# Stop a running execution
n8n-cli execution stop <id>

# Delete an execution
n8n-cli execution delete <id>

Credentials

# List credentials
n8n-cli credential list

# Get credential metadata (not secrets)
n8n-cli credential get <id>

# Get the schema for a credential type (shows required fields)
n8n-cli credential schema notionApi
n8n-cli credential schema slackOAuth2Api

# Create a credential
n8n-cli credential create --type=notionApi --name='My Notion' --data='{"apiKey":"..."}'
n8n-cli credential create --type=notionApi --name='My Notion' --file=cred.json
cat cred.json | n8n-cli credential create --type=notionApi --name='My Notion' --stdin

# Delete / transfer
n8n-cli credential delete <id>
n8n-cli credential transfer <id> --project=<projectId>

Tip: Use credential schema <type> to discover required fields before creating.

Projects

n8n-cli project list
n8n-cli project get <id>
n8n-cli project create --name="My Project"
n8n-cli project update <id> --name="New Name"
n8n-cli project delete <id>

# Team management
n8n-cli project members <id>
n8n-cli project add-member <id> --user=<userId> --role=<role>
n8n-cli project remove-member <id> --user=<userId>

Variables

n8n-cli variable list
n8n-cli variable create --key=API_ENDPOINT --value=https://api.example.com
n8n-cli variable update <id> --key=API_ENDPOINT --value=https://new-api.example.com
n8n-cli variable delete <id>

Data Tables

# CRUD
n8n-cli data-table list
n8n-cli data-table get <id>
n8n-cli data-table create --name=Inventory --columns='[{"name":"item","type":"string"},{"name":"qty","type":"number"}]'
n8n-cli data-table delete <id>

# Row operations
n8n-cli data-table rows <id>
n8n-cli data-table add-rows <id> --file=rows.json
n8n-cli data-table update-rows <id> --file=rows.json
n8n-cli data-table upsert-rows <id> --file=rows.json
n8n-cli data-table delete-rows <id> --ids=row1,row2,row3

# All row commands support --stdin
cat rows.json | n8n-cli data-table add-rows <id> --stdin

Users

n8n-cli user list
n8n-cli user get <id>

Other

# Security audit
n8n-cli audit
n8n-cli audit --categories=credentials,nodes

# Source control
n8n-cli source-control pull

# View config
n8n-cli config show

Composability Patterns

The CLI is designed to be piped and composed:

# Get all workflow IDs
n8n-cli workflow list --jq '.[].id'

# Get the name of the first workflow
n8n-cli workflow list --jq '.[0].name'

# Export a workflow to a file
n8n-cli workflow get 1234 --json > workflow-backup.json

# Find failing executions for a workflow
n8n-cli execution list --workflow=1234 --status=error --json

# Pipe workflow JSON for modification
n8n-cli workflow get 1234 --json | jq '.name = "Updated Name"' | n8n-cli workflow update 1234 --stdin

# Table output without headers for shell parsing
n8n-cli workflow list --no-header | awk '{print $1}'

# Debug API calls
n8n-cli workflow list --debug 2>debug.log

Workflow JSON Structure

When creating or updating workflows, the JSON follows this structure:

{
  "name": "My Workflow",
  "nodes": [
    {
      "name": "Start",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [250, 300],
      "parameters": {}
    },
    {
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "position": [450, 300],
      "parameters": {
        "url": "https://api.example.com/data",
        "method": "GET"
      }
    }
  ],
  "connections": {
    "Start": {
      "main": [[{ "node": "HTTP Request", "type": "main", "index": 0 }]]
    }
  }
}

Key points:

nodes[].type follows the pattern n8n-nodes-base.<nodeName> for built-in nodes
connections is keyed by source node name, with main output arrays
Each connection specifies target node, type (usually main), and output index
Use workflow get <id> --json to see real examples from the instance

🛠️ Что это

n8n CLI Automation — это навык, который позволяет управлять экземпляром n8n через командную строку с помощью утилиты n8n-cli. Он даёт возможность автоматизировать рутинные операции с воркфлоу, креденшиалами, проектами, тегами, переменными, таблицами данных и пользователями — без необходимости заходить в веб-интерфейс. Навык особенно полезен для разработчиков, DevOps-инженеров и всех, кто хочет встроить n8n в свои скрипты или CI/CD-пайплайны.

⚙️ Как работает

🔐 Настройка и аутентификация

Перед началом работы нужно указать URL экземпляра n8n и API-ключ. Это можно сделать тремя способами:

Интерактивный вход: n8n-cli login — сохраняет данные в ~/.n8n-cli/config.json.
Прямая конфигурация: n8n-cli config set-url URL и `n8n-cli config set-api-key `API_KEY.
Переменные окружения: установить N8N_URL и N8N_API_KEY — тогда файл конфигурации не нужен.

Все команды поддерживают глобальные флаги: --url, --apiKey, --format (table, json, id-only), --jq для фильтрации JSON, --quiet, --no-header и --debug.

💡 Авто-JSON: Если вывод команды перенаправляется в пайп (не в терминал), формат автоматически переключается на JSON — это удобно для скриптов.

📋 Управление воркфлоу

Список: n8n-cli workflow list с фильтрами --active, --tag, --name, --limit.
Просмотр: n8n-cli workflow get id`` — полный JSON с узлами и соединениями.
Создание: из файла (--file=workflow.json) или через stdin (cat workflow.json | n8n-cli workflow create --stdin).
Обновление: аналогично созданию, но с указанием id.
Активация/деактивация: n8n-cli workflow activate id / `deactivate `id.
Удаление: n8n-cli workflow delete id``.
Перемещение в другой проект: n8n-cli workflow transfer id --project=projectId``.
Теги: n8n-cli workflow tags id``.

📊 Выполнения (Executions)

Список: n8n-cli execution list с фильтрами --workflow, --status (canceled, error, running, success, waiting), --limit.
Детали: n8n-cli execution get id`` с опцией --include-data для полного ввода/вывода узлов.
Повтор: n8n-cli execution retry id``.
Остановка: n8n-cli execution stop id``.
Удаление: n8n-cli execution delete id``.

🔑 Креденшиалы

Список: n8n-cli credential list.
Просмотр метаданных: n8n-cli credential get id`` (секреты не показываются).
Схема типа: n8n-cli credential schema notionApi — показывает обязательные поля для создания.
Создание: n8n-cli credential create --type=notionApi --name='My Notion' --data='{"apiKey":"..."}' или через файл/stdin.
Удаление и перемещение: delete и transfer.

🏢 Проекты

CRUD: list, get, create, update, delete.
Управление участниками: members, add-member, remove-member с указанием роли.

🏷️ Теги, переменные, таблицы данных

Теги: list, create, update, delete.
Переменные: list, create, update, delete — для хранения конфигурационных значений.
Таблицы данных: полноценный CRUD для таблиц и операций со строками (rows, add-rows, update-rows, upsert-rows, delete-rows). Все операции со строками поддерживают --stdin.

👥 Пользователи и прочее

Пользователи: list, get.
Аудит безопасности: n8n-cli audit с фильтром по категориям (credentials, nodes).
Source control: n8n-cli source-control pull.
Просмотр конфигурации: n8n-cli config show.

🔗 Композиция и пайпы

CLI спроектирован для использования в пайпах. Примеры:

# Получить все ID воркфлоу
n8n-cli workflow list --jq '.[].id'

# Экспортировать воркфлоу в файл
n8n-cli workflow get 1234 --json > workflow-backup.json

# Найти ошибочные выполнения
n8n-cli execution list --workflow=1234 --status=error --json

# Изменить имя воркфлоу через jq и обновить
n8n-cli workflow get 1234 --json | jq '.name = "Updated Name"' | n8n-cli workflow update 1234 --stdin

🎯 Когда использовать

Автоматизация развёртывания: создание, обновление и активация воркфлоу из CI/CD.
Массовые операции: например, деактивация всех воркфлоу с тегом staging.
Мониторинг и отладка: быстрый просмотр ошибочных выполнений и их повтор.
Управление доступом: добавление/удаление участников проектов.
Бэкапы и миграции: экспорт воркфлоу в JSON и импорт на другой экземпляр.
Интеграция с LLM-агентами: навык позволяет языковой модели выполнять действия в n8n по текстовой команде.

⚠️ Важно знать

Структура JSON воркфлоу: узлы имеют тип вида n8n-nodes-base.nodeName``, соединения описываются в объекте connections, где ключ — имя исходного узла. Для просмотра реального примера используйте n8n-cli workflow get id --json.
Безопасность: API-ключ даёт полный доступ к экземпляру, поэтому храните его в секретах (переменные окружения или защищённый файл конфигурации).
Флаг --no-header удобен для парсинга вывода в shell-скриптах (например, с awk).
Флаг --debug выводит HTTP-детали в stderr, что помогает при отладке.
Команда credential schema — ваш лучший друг перед созданием креденшиала: она покажет, какие поля обязательны.

Навык превращает n8n в полностью управляемую из командной строки платформу, открывая широкие возможности для автоматизации и интеграции.

Установка одной командой.

npx skillfish add n8n-io/n8n n8n-cli

Источник: https://mcpmarket.com/tools/skills/n8n-cli-automation