helbertparanhos/n8n-pro-mcp

helbertparanhos/n8n-pro-mcp

от helbertparanhos
MCP сервер для полного управления self-hosted n8n: 51 инструмент охватывает workflows, executions, теги, credentials, проекты, пользователей и мониторинг с поддержкой queue mode. Полезен DevOps и р...

n8n Pro MCP ⚙️

Full-instance management for self-hosted n8n — including queue mode — through the Model Context Protocol. 51 tools covering workflows, executions, tags, credentials, variables, projects, users, security audit, source control and health monitoring.

npm version License: MIT GitHub Stars GitHub Forks GitHub Issues Glama Quality

TypeScript Node.js MCP Claude Code Cursor Claude Desktop

Instagram YouTube LinkedIn Buy Me A Coffee Strat Academy

n8n-pro-mcp connects Claude Code, Claude Desktop, Cursor or any MCP client to your n8n instance via the official n8n public API v1, with automatic cursor pagination, exponential-backoff retry on reads (writes and webhook calls are never retried, so side effects can't duplicate), and offline workflow validation that catches the classic n8n mistakes (malformed {{ }} expressions, webhook data accessed without .body, Code nodes missing return [{json: {...}}]) before they reach your instance.

Why this one?

  • Queue mode first-classlist_running_executions (live queue view), get_execution_stats (success rate + average duration per workflow) and check_health (healthz, readiness, API auth) were built for instances running EXECUTIONS_MODE=queue with workers and webhook processors. N8N_WEBHOOK_BASE_URL lets webhook calls target dedicated webhook processors.
  • Complete API v1 coverage — tags, variables, projects, users, source control and cross-project transfers, beyond the usual workflow/execution CRUD.
  • Offline validation built invalidate_workflow_json checks structure, connection integrity, orphan nodes, expression syntax, webhook .body access, Code node return format and hardcoded secrets without any API call. create_workflow/update_workflow run it automatically and refuse invalid payloads.
  • Safe partial updatesupdate_workflow fetches the current workflow, merges only what you pass and strips read-only fields, so you never lose nodes by sending an incomplete PUT.
  • Tags by nameset_workflow_tags accepts tag names and creates missing ones; no manual ID juggling.
  • Ops compositions the raw API doesn't havesummarize_execution_error (just the failing node + error, not a giant JSON dump), prune_executions (bulk cleanup with dry run), wait_for_execution (poll until terminal), clone_workflow and set_workflows_active_by_tag (tag-based kill switch).
Инструменты были проиндексированы:
activate_workflow

Активирует рабочий процесс, чтобы его триггеры (вебхуки, расписания, потребители очередей) начали работать.

Параметры
  • idstringобязательный

    Workflow ID

add_user_to_project

Добавляет пользователя в проект с ролью в проекте (admin/editor/viewer). Находит идентификаторы пользователей с помощью list_users и идентификаторы проектов с помощью list_projects.

Параметры
  • projectIdstringобязательный

    Project ID

  • roleenum

    Role of the user inside the project

  • userIdstringобязательный

    User ID (see list_users)

change_user_project_role

Изменяет роль пользователя в проекте (admin/editor/viewer).

Параметры
  • projectIdstringобязательный

    Project ID

  • roleenumобязательный

    New role inside the project

  • userIdstringобязательный

    User ID

change_user_role

Изменяет глобальную роль пользователя (admin ↔ member). Роль владельца инстанса нельзя переназначить.

Параметры
  • idOrEmailstringобязательный

    User ID or email

  • newRoleenumобязательный

    New global role

check_healthтолько чтение

Проверяет работоспособность инстанса: /healthz (процесс запущен), /healthz/readiness (БД подключена и мигрирована), а также доступность REST API и аутентификацию. В режиме очереди проверяет главный процесс: используйте вместе с list_running_executions и get_execution_stats для оценки пропускной способности очереди.

Параметры

Без параметров.

clone_workflow

Дублирует workflow: получает исходный и создаёт неактивную копию (те же узлы, соединения, настройки и ссылки на учётные данные) под новым именем. Полезен для безопасного экспериментирования на рабочих workflows.

Параметры
  • idstringобязательный

    Source workflow ID

  • newNamestring

    Name for the copy (default: '<source name> (copy)')

create_credential

Создает учетные данные на экземпляре. Сначала использует get_credential_schema, чтобы увидеть, какие поля требует тип учетных данных. Публичный API n8n никогда не возвращает секреты учетных данных - только метаданные.

Параметры
  • dataobjectобязательный

    Credential fields as required by the type's schema

  • namestringобязательный

    Display name for the credential

  • typestringобязательный

    Credential type name, e.g. 'slackApi', 'httpHeaderAuth'

create_project

Создаёт новый командный проект.

Параметры
  • namestringобязательный

    Project name

create_tag

Создаёт новый тег.

Параметры
  • namestringобязательный

    Tag name

create_user

Приглашает нового пользователя в инстанс с глобальной ролью. Возвращает URL для принятия приглашения, если email не настроен в инстансе.

Параметры
  • emailstringобязательный

    Email of the user to invite

  • roleenum

    Global role

create_variable

Создаёт переменную экземпляра (затем доступна в рабочих процессах как $vars.<key>).

Параметры
  • keystringобязательный

    Variable key (letters, numbers, underscores)

  • valuestringобязательный

    Variable value (always stored as string)

create_workflow

Создаёт новый workflow из JSON (имя, узлы, соединения, настройки). Сначала выполняет офлайн-валидацию и отказывается создавать некорректные workflow, если только skipValidation=true. Новые workflow создаются неактивными: используйте activate_workflow после этого.

Параметры
  • connectionsobjectобязательный

    Connections object keyed by source node name, e.g. {"Webhook": {"main": [[{"node": "Set", "type": "main", "index": 0}]]}}

  • namestringобязательный

    Workflow name

  • nodesobject[]обязательный

    Workflow nodes

  • settingsobject

    Workflow settings (executionOrder, errorWorkflow, timezone, ...)

  • skipValidationboolean

    Create even if offline validation finds errors

deactivate_workflow

Деактивирует рабочий процесс: срабатывания прекращают запускаться, но рабочий процесс и его история сохраняются.

Параметры
  • idstringобязательный

    Workflow ID

delete_credential

Удаляет учётные данные по ID. Рабочие процессы, которые на них ссылаются, будут завершаться сбоем до переназначения.

Параметры
  • idstringобязательный

    Credential ID

delete_execution

Удаляет одну запись о выполнении по ID (освобождает место в базе данных; отменить невозможно).

Параметры
  • idstringобязательный

    Execution ID

delete_project

Навсегда удаляет проект по ID — действие нельзя отменить. Сначала перенесите из него рабочие процессы и учётные данные (transfer_workflow / transfer_credential).

Параметры
  • idstringобязательный

    Project ID

delete_tag

Удаляет тег по ID (удаляет его из всех рабочих процессов; сами рабочие процессы не затрагиваются).

Параметры
  • idstringобязательный

    Tag ID

delete_user

Навсегда удаляет пользователя из экземпляра по ID или email — необратимо; пользователь теряет доступ немедленно.

Параметры
  • idOrEmailstringобязательный

    User ID or email

delete_variable

Безвозвратно удаляет переменную по ID: это действие нельзя отменить. Рабочие процессы, читающие $vars.<key>, после этого будут получать undefined.

Параметры
  • idstringобязательный

    Variable ID

delete_workflow

Окончательно удаляет рабочий процесс по идентификатору. Это действие нельзя отменить — рассмотрите deactivate_workflow, если нужно только остановить его.

Параметры
  • idstringобязательный

    Workflow ID

generate_audit

Генерирует встроенный аудит безопасности n8n: отмечает заброшенные рабочие процессы, неиспользуемые учётные данные, опасные узлы (доступ к файловой системе/экземпляру) и другое. Опционально ограничивает категории или настраивает порог заброшенных рабочих процессов.

Параметры
  • categoriesenum[]

    Audit categories to run (default: all)

  • daysAbandonedWorkflowinteger

    Days without execution for a workflow to count as abandoned (n8n default: 90)

get_credential_schemaтолько чтение

Получает JSON-схему типа учётных данных: какие поля ему нужны (например, 'slackApi' → accessToken). Используйте перед create_credential.

Параметры
  • credentialTypeNamestringобязательный

    Credential type name, e.g. 'githubApi'

get_executionтолько чтение

Получает одно выполнение по ID. includeData=true возвращает полные данные выполнения (входные/выходные данные узлов и детали ошибок) - полезно для отладки неудачного выполнения.

Параметры
  • idstringобязательный

    Execution ID

  • includeDataboolean

    Include full node-level run data (large)

get_execution_statsтолько чтение

Агрегирует состояние выполнения за последний период: количество успешных/ошибочных/ожидающих выполнений для каждого рабочего процесса, процент успеха и среднюю продолжительность. Дашборд queue-mode одним вызовом — выявляет сбойные или медленные рабочие процессы.

Параметры
  • sampleinteger

    How many recent executions to aggregate

  • workflowIdstring

    Restrict stats to one workflow

get_userтолько чтение

Получает одного пользователя по ID или email-адресу.

Параметры
  • idOrEmailstringобязательный

    User ID or email

  • includeRoleboolean

    Include the user's global role

get_workflowтолько чтение

Получает рабочий процесс по ID, включая полные узлы и соединения JSON. Используйте mode='summary', чтобы получить только метаданные и список узлов (дешевле для проверки).

Параметры
  • idstringобязательный

    Workflow ID

  • modeenum

    full = complete JSON; summary = metadata + node names/types only

get_workflow_tagsтолько чтение

Перечисляет теги, прикреплённые к рабочему процессу.

Параметры
  • workflowIdstringобязательный

    Workflow ID

list_executionsтолько чтение

Выводит список выполнений с фильтрами (status, workflow, project) и автоматической пагинацией. Возвращает краткие сводки с длительностью - используйте get_execution для получения полных данных на уровне узлов.

Параметры
  • maxItemsinteger

    Max executions to return

  • projectIdstring

    Filter by project ID

  • statusenum

    Filter by execution status (older n8n versions only accept error/success/waiting)

  • workflowIdstring

    Filter by workflow ID

list_projectsтолько чтение

Перечисляет проекты на инстансе (требуется функция Projects, доступна в лицензионных планах). Идентификаторы проектов используются transfer_workflow / transfer_credential и в качестве фильтров.

Параметры
  • maxItemsinteger

    Max projects to return

list_running_executionsтолько чтение

Режим просмотра очереди: отображает список выполнений, которые в данный момент выполняются или ожидают в очереди. Сначала пытается использовать фильтр статуса API, а затем переходит к сканированию последних выполнений, у которых нет времени остановки.

Параметры
  • maxItemsinteger

    Max executions to return

list_tagsтолько чтение

Выводит список всех тегов на экземпляре с их ID (ID необходимы для set_workflow_tags).

Параметры
  • maxItemsinteger

    Max tags to return

list_usersтолько чтение

Перечисляет пользователей экземпляра с их глобальными ролями (требуется ключ API владельца).

Параметры
  • includeRoleboolean

    Include each user's global role

  • maxItemsinteger

    Max users to return

  • projectIdstring

    Filter to members of a project

list_variablesтолько чтение

Перечисляет переменные экземпляра (доступны в рабочих процессах через $vars.<key>). Требует лицензированного плана n8n с функцией Variables.

Параметры
  • maxItemsinteger

    Max variables to return

list_workflowsтолько чтение

Перечисляет рабочие процессы с необязательными фильтрами (active, tag names, project, name) и автоматической пагинацией на основе курсора. Возвращает id, name, active state, tags и timestamps - никогда не возвращает тяжелые данные узла.

Параметры
  • activeboolean

    Filter by active state

  • maxItemsinteger

    Max workflows to return across pages

  • namestring

    Filter by exact workflow name

  • projectIdstring

    Filter by project ID

  • tagsstring

    Comma-separated tag names to filter by

prune_executions

Массово удаляет записи о завершённых выполнениях по фильтру (статус, workflow, старше N дней), чтобы освободить место в базе данных. По умолчанию работает как холостой прогон - установите dryRun=false для фактического удаления. Удаление необратимо и не может быть отменено. Выполняющиеся или ожидающие выполнения никогда не затрагиваются.

Параметры
  • dryRunboolean

    Preview what would be deleted without deleting

  • maxDeleteinteger

    Safety cap per call

  • olderThanDaysnumber

    Only prune executions that stopped more than N days ago

  • statusenum

    Only prune executions with this terminal status

  • workflowIdstring

    Only prune executions of this workflow

pull_source_control

Извлекает изменения из подключённого репозитория системы управления версиями (требует настройки функции Source Control на экземпляре). force=true навсегда отбрасывает локальные изменения на экземпляре - отмена невозможна.

Параметры
  • forceboolean

    Discard local changes and force-pull

  • variablesobject

    Values for variables defined in the repository

remove_user_from_project

Удаляет пользователя из проекта (пользователь сохраняет свою учётную запись экземпляра).

Параметры
  • projectIdstringобязательный

    Project ID

  • userIdstringобязательный

    User ID

retry_execution

Повторно запускает завершившееся с ошибкой или остановленное выполнение по ID. Требуется актуальная версия n8n, поддерживающая повтор в публичном API, если недоступно (404), перезапустите рабочий процесс через run_webhook.

Параметры
  • idstringобязательный

    Execution ID to retry

run_webhook

Запускает рабочий процесс через его узел Webhook. Вызывает {instance}/webhook/{path} (или /webhook-test/{path} с параметром test=true, что требует открытого рабочего процесса в режиме 'Listen for test event'). В режиме очереди вызов возвращается в соответствии с режимом ответа вебхука.

Параметры
  • headersobject

    Extra HTTP headers (e.g. webhook auth)

  • methodenum

    HTTP method the Webhook node expects

  • pathstringобязательный

    Webhook path as configured in the Webhook node (without /webhook/ prefix)

  • payloadobject

    JSON body to send (POST/PUT/DELETE — not allowed with GET)

  • testboolean

    Call the test URL (/webhook-test/) instead of production

search_workflowsтолько чтение

Ищет рабочие процессы по произвольному тексту в названиях, именах узлов и типах узлов (на стороне клиента по списку — находит, например, каждый рабочий процесс, использующий заданный тип узла или затрагивающий заданный сервис).

Параметры
  • activeboolean

    Restrict to active/inactive workflows

  • maxScaninteger

    Max workflows to scan

  • querystringобязательный

    Case-insensitive text to match against workflow name, node names and node types

set_workflows_active_by_tag

Массово активирует или деактивирует все рабочие процессы с определённым тегом - операционный аварийный выключатель (например, деактивировать всё с тегом 'client-x'). По умолчанию выполняется как пробный запуск; установите dryRun=false для применения. Рабочие процессы, уже находящиеся в нужном состоянии, пропускаются.

Параметры
  • activebooleanобязательный

    Desired state: true = activate, false = deactivate

  • dryRunboolean

    Preview affected workflows without changing them

  • tagstringобязательный

    Tag name (see list_tags)

set_workflow_tags

Заменяет теги рабочего процесса. Принимает NAMES тегов — автоматически преобразует их в ID и, при createMissing=true, создаёт теги, которых ещё не существует. Передайте пустой список, чтобы удалить все теги.

Параметры
  • createMissingboolean

    Create tags that don't exist yet

  • tagNamesstring[]обязательный

    Full desired set of tag names (replaces current tags)

  • workflowIdstringобязательный

    Workflow ID

summarize_execution_errorтолько чтение

Отлаживает неудачное выполнение без перегрузки контекста: извлекает полные данные о запуске и возвращает только узел, на котором произошла ошибка, сообщение/описание ошибки, короткий стек и ошибки по узлам. Используйте вместо get_execution с includeData=true, когда нужно узнать только, что сломалось.

Параметры
  • idstringобязательный

    Execution ID (see list_executions with status=error)

transfer_credential

Перенести учётные данные в другой проект (требуется функция Projects).

Параметры
  • destinationProjectIdstringобязательный

    Target project ID (see list_projects)

  • idstringобязательный

    Credential ID

transfer_workflow

Переносит рабочий процесс в другой проект (требует функции Projects на экземпляре).

Параметры
  • destinationProjectIdstringобязательный

    Target project ID (see list_projects)

  • idstringобязательный

    Workflow ID

update_project

Переименовывает проект по ID.

Параметры
  • idstringобязательный

    Project ID

  • namestringобязательный

    New project name

update_tag

Переименовывает тег по идентификатору (все рабочие процессы, использующие его, видят новое имя).

Параметры
  • idstringобязательный

    Tag ID

  • namestringобязательный

    New tag name

update_variable

Обновляет пару ключ/значение существующей переменной по идентификатору переменной (см. list_variables для получения идентификаторов).

Параметры
  • idstringобязательный

    Variable ID

  • keystringобязательный

    Variable key

  • valuestringобязательный

    New value

update_workflow

Обновляет рабочий процесс частично: получает текущую версию, объединяет только те поля, которые вы передаёте (name, nodes, connections, settings), проверяет в автономном режиме и отправляет результат методом PUT. Передавайте полные массивы nodes/connections при их изменении, они заменяют существующие.

Параметры
  • connectionsobject
  • idstringобязательный

    Workflow ID

  • namestring
  • nodesobject[]
  • settingsobject
  • skipValidationboolean

    Update even if offline validation finds errors

validate_workflow_jsonтолько чтение

Проверяет JSON рабочего процесса в автономном режиме (без вызова API): структуру, уникальные имена узлов, целостность соединений, узлы-сироты, синтаксис выражений {{ }}, доступ к .body вебхука, формат возврата узла Code и жёстко заданные секреты. Запускается перед create_workflow/update_workflow.

Параметры
  • workflowobjectобязательный

    The workflow JSON to validate

wait_for_executionтолько чтение

Опрашивает выполнение, пока оно не достигнет конечного состояния (success/error/crashed/canceled) или не истечёт таймаут. Возвращает результат досрочно с waiting=true, если выполнение приостанавливается на узле Wait. Закрывает цикл после run_webhook в режиме очереди, где выполнение происходит асинхронно на рабочих узлах. Таймаут best-effort: каждый запрос опроса имеет собственный HTTP-таймаут, поэтому общее реальное время может незначительно превысить timeoutSeconds.

Параметры
  • idstringобязательный

    Execution ID to wait for

  • pollSecondsinteger

    Interval between checks

  • timeoutSecondsinteger

    Max time to wait

Похожие MCP-сервера

mshegolev/gitlab-ci-mcp

mshegolev/gitlab-ci-mcp

MCP сервер для GitLab CI/CD. Позволяет ИИ-агентам управлять пайплайнами, джобами, расписаниями и репозиторием (ветки, теги, MR). Работает с любым GitLab (SaaS/self-hosted), для корпоративных сетей. 23 инструмента.

Python2
joaoh82/rustunnel

joaoh82/rustunnel

rustunnel — MCP сервер для безопасного туннелирования локальных сервисов через WebSocket с TLS. Включает HTTP/TCP прокси, дашборд, метрики. Разработчики и AI-агенты (Cursor, Claude) быстро публикуют и отлаживают. Модель: Pay-as-you-go или self-host.

Rust655
ellmos-ai/n8n-manager-mcp

ellmos-ai/n8n-manager-mcp

MCP сервер для управления n8n workflow через AI ассистентов — Claude, Cursor и других. Включает 18 инструментов: создание, редактирование, активация, экспорт и импорт workflow, безопасность с резервными копиями и аудитом. Подходит для автоматизации и интеграции.

TypeScript2
depwire/depwire

depwire/depwire

Depwire – MCP сервер для AI-ассистентов, строящий детерминированный граф зависимостей кода на 16 языках. Позволяет симулировать удаление символов, проверять безопасность и оценивать архитектурное здоровье. Все 23 инструмента работают локально, без отправки кода.

TypeScript61
Daghis/teamcity-mcp

Daghis/teamcity-mcp

MCP сервер объединяет AI-ассистентов с TeamCity CI/CD. Разработчики запускают сборки, просматривают логи, управляют параметрами и агентами из редактора. Режимы: Dev для повседневных задач и Full дл...

TypeScript29
JaviMaligno/mcp-server-bitbucket

JaviMaligno/mcp-server-bitbucket

MCP сервер для интеграции с Bitbucket: управление репозиториями, пулл-реквестами и пайплайнами. Работает с Claude Code, Cursor и любыми MCP-клиентами. Также доступны CI/CD, вебхуки и управление ветками.

Python2
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин