n8n-cli

A command-line interface for interacting with n8n workflow automation.

---

Note: Most commands work with standard n8n. However, the trigger command requires the execute workflow endpoint, which is pending merge into n8n core. Until then, trigger requires a custom n8n build.

Installation

pip install n8n-cli

Or with pipx (recommended):

pipx install n8n-cli

Quick Start

# Configure your n8n instance
n8n-cli configure

# List all workflows
n8n-cli workflows

# Trigger a workflow
n8n-cli trigger <workflow-id>

# Check execution status
n8n-cli execution <execution-id>

Features

• Workflow Management - List, create, update, delete, enable, and disable workflows
• Execution Control - Trigger workflows, monitor executions, and retrieve results
• Flexible Output - JSON (default) or formatted tables
• Agent-Friendly - Designed for AI agent integration with structured JSON output
• Secure Configuration - Credentials stored with proper file permissions

Commands

Command	Description
configure	Set up n8n API credentials
workflows	List all workflows
workflow	Get workflow details
create	Create a new workflow
update	Update an existing workflow
update-node	Update a specific node parameter
delete	Delete a workflow
enable	Activate a workflow
disable	Deactivate a workflow
executions	List workflow executions
execution	Get execution details
trigger	Trigger a workflow
credentials	Manage credentials (create, delete, schema)

Documentation

For detailed documentation, see the Wiki:

• Configuration - Setup and environment variables
• Command Reference - Full command documentation
• Agent Integration - Using with AI agents
• Environment Variables - All configuration options
• Troubleshooting - Common issues and solutions
• Development - Contributing guide