AGENT SKILL

pm-n8n

n8n connector knowledge and safe action guide.

License 许可
AGPL-3.0
所属仓库
polymetrics-ai/cli
最近更新
2026-09-21
Stars
★ 7
Forks
0

01 前言 Front Matter

name
pm-n8n
description
n8n connector knowledge and safe action guide.

03 SKILL.md 正文

pm-n8n

Purpose

Reads n8n workflows, executions, tags, users, variables, projects, data tables, and credential metadata; writes supported n8n public REST API mutations.

Icon

  • id: n8n
  • asset: icons/n8n.svg
  • source: upstream_registry
  • review_status: upstream_seeded
  • review_url: https://docs.n8n.io/api/

Capabilities

  • check=true catalog=true read=true write=true query=false
  • Integration type: api

Authentication

  • Use pm credentials add with --from-env or --value-stdin for secret fields.

Configuration

  • base_url (required)
  • credential_id
  • credential_type_name
  • data_table_column_id
  • data_table_filter
  • data_table_id
  • data_table_search
  • data_table_sort_by
  • exclude_pinned_data
  • execution_id
  • execution_status
  • ignore_data_size_limit
  • include_execution_data
  • include_role
  • max_pages
  • mode
  • page_size
  • project_id
  • project_user_id
  • redact_execution_data
  • tag_id
  • user_id
  • variable_id
  • variable_state
  • workflow_active
  • workflow_id
  • workflow_name
  • workflow_tags
  • workflow_version_id
  • api_key (secret) (required)

ETL Streams

  • workflows:
    • primary key: id
    • cursor: updatedAt
    • fields: active(boolean), createdAt(string), id(string), isArchived(boolean), name(string), triggerCount(integer), updatedAt(string), versionId(string)
  • workflow:
    • primary key: id
    • cursor: updatedAt
    • fields: active(boolean), connections(object), createdAt(string), description(string), id(string), isArchived(boolean), name(string), nodes(array), settings(object), shared(array), tags(array), triggerCount(integer), updatedAt(string), versionId(string)
  • workflow_version:
    • primary key: versionId
    • cursor: updatedAt
    • fields: authors(string), connections(object), createdAt(string), description(string), name(string), nodeGroups(array), nodes(array), updatedAt(string), versionId(string), workflowId(string)
  • workflow_tags:
    • primary key: id
    • cursor: updatedAt
    • fields: createdAt(string), id(string), name(string), updatedAt(string)
  • executions:
    • primary key: id
    • cursor: startedAt
    • fields: finished(boolean), id(string), mode(string), retryOf(string), startedAt(string), status(string), stoppedAt(string), workflowId(string)
  • execution:
    • primary key: id
    • cursor: startedAt
    • fields: customData(object), data(object), finished(boolean), id(string), mode(string), retryOf(string), retrySuccessId(string), startedAt(string), status(string), stoppedAt(string), waitTill(string), workflowId(string)
  • execution_tags:
    • primary key: id
    • cursor: updatedAt
    • fields: createdAt(string), id(string), name(string), updatedAt(string)
  • tags:
    • primary key: id
    • cursor: updatedAt
    • fields: createdAt(string), id(string), name(string), updatedAt(string)
  • tag:
    • primary key: id
    • cursor: updatedAt
    • fields: createdAt(string), id(string), name(string), updatedAt(string)
  • users:
    • primary key: id
    • cursor: updatedAt
    • fields: createdAt(string), email(string), firstName(string), id(string), isPending(boolean), lastName(string), role(string), updatedAt(string)
  • user:
    • primary key: id
    • cursor: updatedAt
    • fields: createdAt(string), email(string), firstName(string), id(string), isPending(boolean), lastName(string), mfaEnabled(boolean), role(string), updatedAt(string)
  • variables:
    • primary key: id
    • fields: id(string), key(string), project(object), projectId(string), type(string), value(string)
  • projects:
    • primary key: id
    • fields: id(string), name(string), type(string)
  • project_members:
    • primary key: id
    • fields: createdAt(string), email(string), firstName(string), id(string), lastName(string), role(string), updatedAt(string)
  • credentials:
    • primary key: id
    • cursor: updatedAt
    • fields: createdAt(string), id(string), isGlobal(boolean), isManaged(boolean), isResolvable(boolean), name(string), resolvableAllowFallback(boolean), resolverId(string), type(string), updatedAt(string)
  • credential:
    • primary key: id
    • cursor: updatedAt
    • fields: createdAt(string), id(string), isGlobal(boolean), isManaged(boolean), isResolvable(boolean), name(string), resolvableAllowFallback(boolean), resolverId(string), type(string), updatedAt(string)
  • credential_schema:
    • fields: displayName(string), documentationUrl(string), name(string), properties(array)
  • data_tables:
    • primary key: id
    • cursor: updatedAt
    • fields: columns(array), createdAt(string), id(string), name(string), projectId(string), updatedAt(string)
  • data_table:
    • primary key: id
    • cursor: updatedAt
    • fields: columns(array), createdAt(string), id(string), name(string), projectId(string), updatedAt(string)
  • data_table_rows:
    • primary key: id
    • cursor: updatedAt
    • fields: createdAt(string), id(string), updatedAt(string)
  • data_table_columns:
    • primary key: id
    • fields: dataTableId(string), id(string), index(integer), name(string), type(string)

Sync Modes

  • ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped

Reverse ETL Actions

  • create_workflow:
    • endpoint: POST /workflows
    • required fields: name, nodes, connections, settings
    • risk: external mutation; approval required
  • update_workflow:
    • endpoint: PUT /workflows/{{ record.workflow_id }}
    • required fields: workflow_id, name, nodes, connections, settings
    • risk: external mutation; approval required
  • publish_workflow:
    • endpoint: POST /workflows/{{ record.workflow_id }}/activate
    • required fields: workflow_id
    • risk: external mutation; approval required
  • deactivate_workflow:
    • endpoint: POST /workflows/{{ record.workflow_id }}/deactivate
    • required fields: workflow_id
    • risk: external mutation; approval required
  • archive_workflow:
    • endpoint: POST /workflows/{{ record.workflow_id }}/archive
    • required fields: workflow_id
    • risk: external mutation; approval required
  • unarchive_workflow:
    • endpoint: POST /workflows/{{ record.workflow_id }}/unarchive
    • required fields: workflow_id
    • risk: external mutation; approval required
  • transfer_workflow:
    • endpoint: PUT /workflows/{{ record.workflow_id }}/transfer
    • required fields: workflow_id, destinationProjectId
    • risk: external mutation; approval required
  • retry_execution:
    • endpoint: POST /executions/{{ record.execution_id }}/retry
    • required fields: execution_id
    • risk: external mutation; approval required
  • stop_execution:
    • endpoint: POST /executions/{{ record.execution_id }}/stop
    • required fields: execution_id
    • risk: external mutation; approval required
  • stop_executions:
    • endpoint: POST /executions/stop
    • required fields: status
    • risk: external mutation; approval required
  • create_tag:
    • endpoint: POST /tags
    • required fields: name
    • risk: external mutation; approval required
  • update_tag:
    • endpoint: PUT /tags/{{ record.tag_id }}
    • required fields: tag_id, name
    • risk: external mutation; approval required
  • create_variable:
    • endpoint: POST /variables
    • required fields: key, value
    • risk: external mutation; approval required
  • update_variable:
    • endpoint: PUT /variables/{{ record.variable_id }}
    • required fields: variable_id, key, value
    • risk: external mutation; approval required
  • create_project:
    • endpoint: POST /projects
    • required fields: name
    • risk: external mutation; approval required
  • update_project:
    • endpoint: PUT /projects/{{ record.project_id }}
    • required fields: project_id, name
    • risk: external mutation; approval required
  • add_project_users:
    • endpoint: POST /projects/{{ record.project_id }}/users
    • required fields: project_id, relations
    • risk: external mutation; approval required
  • change_project_user_role:
    • endpoint: PATCH /projects/{{ record.project_id }}/users/{{ record.project_user_id }}
    • required fields: project_id, project_user_id, role
    • risk: external mutation; approval required
  • create_data_table:
    • endpoint: POST /data-tables
    • required fields: name, columns
    • risk: external mutation; approval required
  • update_data_table:
    • endpoint: PATCH /data-tables/{{ record.data_table_id }}
    • required fields: data_table_id, name
    • risk: external mutation; approval required
  • insert_data_table_rows:
    • endpoint: POST /data-tables/{{ record.data_table_id }}/rows
    • required fields: data_table_id, data
    • risk: external mutation; approval required
  • update_data_table_rows:
    • endpoint: PATCH /data-tables/{{ record.data_table_id }}/rows/update
    • required fields: data_table_id, filter, data
    • risk: external mutation; approval required
  • upsert_data_table_row:
    • endpoint: POST /data-tables/{{ record.data_table_id }}/rows/upsert
    • required fields: data_table_id, filter, data
    • risk: external mutation; approval required
  • add_data_table_column:
    • endpoint: POST /data-tables/{{ record.data_table_id }}/columns
    • required fields: data_table_id, name, type
    • risk: external mutation; approval required
  • update_data_table_column:
    • endpoint: PATCH /data-tables/{{ record.data_table_id }}/columns/{{ record.data_table_column_id }}
    • required fields: data_table_id, data_table_column_id, name
    • risk: external mutation; approval required
  • test_credential:
    • endpoint: POST /credentials/{{ record.credential_id }}/test
    • required fields: credential_id
    • risk: external mutation; approval required
  • transfer_credential:
    • endpoint: PUT /credentials/{{ record.credential_id }}/transfer
    • required fields: credential_id, destinationProjectId
    • risk: external mutation; approval required
  • pull_source_control:
    • endpoint: POST /source-control/pull
    • risk: external mutation; approval required
  • generate_audit:
    • endpoint: POST /audit
    • risk: external mutation; approval required

Security

  • read risk: external n8n instance API read of workflow, execution, tag, user, variable, project, data table, and credential metadata
  • write risk: external n8n instance API mutation of workflows, executions, tags, variables, projects, data tables, source-control pull, audit generation, and credential tests/transfers
  • approval: required for all write actions
  • Never pass secret values in chat, shell arguments, logs, docs, or JSON output.

Commands

Inspect as a manual

pm connectors inspect n8n

Inspect as structured JSON

pm connectors inspect n8n --json

Agent Rules

  • Run pm connectors inspect n8n before creating credentials or plans.
  • Use --json only when the caller needs structured output; use the manual for human-readable guidance.
  • Never ask the user to paste secret values into chat.
  • For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.

04 同仓库更多 Skills