n8n CLI

n8n CLI is a lightweight command-line client that communicates with a running n8n instance through the n8n API. It can run from any machine with network access and authenticates using an API key.

Use the API CLI to:

• List and inspect workflows
• Create a workflow from JSON
• Check recent executions
• Create a credential
• Manage projects

All operations respect the permissions of the user and the scope of the API key.

n8n CLI versus server CLI

If you need to manage your n8n instance (backups, license management, emergency resets), see the Server CLI, a built-in tool that runs on the same machine as n8n.

Install n8n-cli

# Use directly with npx (zero install)
npx @n8n/cli workflow list

# Or install globally
npm install -g @n8n/cli

Connect to your instance

n8n-cli config set-url https://your-instance.n8n.cloud
n8n-cli config set-api-key YOUR_API_KEY
n8n-cli config show

• The configuration is saved to ~/.n8n-cli/config.json with restricted file permissions (0600).
• Get your API key from n8n > Settings > n8n API

Alternatively, skip the configuration file and use environment variables:

export N8N_URL=https://your-instance.n8n.cloud
export N8N_API_KEY=your_api_key

Inline flags

n8n-cli --url=https://my-n8n.app.n8n.cloud --api-key=n8n_api_xxxxx workflow list

Resolution order

1. Command-line flags (--url, --api-key)
2. Environment variables (N8N_URL, N8N_API_KEY)
3. Config file (~/.n8n-cli/config.json)

Commands

Every command supports --help for detailed usage.

Output formats

All commands support three output formats via --format:

Examples

• Human-readable table

n8n-cli workflow list

• JSON for scripts

n8n-cli workflow list --format=json | jq '.[] | select(.active) | .id'

• Pipe IDs into another command

n8n-cli workflow list --format=id-only | xargs -I{} n8n-cli workflow deactivate {}

Use as skill with Claude Code

Install the skill so Claude always knows how to use n8n-cli:

n8n-cli skill install --global

Then in Claude Code, type /n8n-cli to load it. Claude can now create, update, and manage workflows on your behalf without requiring an MCP.

Examples

List and inspect workflows

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

Create a workflow from JSON

cat workflow.json | n8n-cli workflow create --stdin

Check recent executions

n8n-cli execution list --status=error --limit=10

Create a credential

n8n-cli credential schema gmailOAuth2  # see required fields first
n8n-cli credential create --type=gmailOAuth2 --name='My Gmail' --file=cred.json

Manage projects

n8n-cli project create --name="My Project"
n8n-cli workflow transfer <id> --project=<projectId>

Export and import packages

n8n-cli package export --workflow-id=<workflow-id> --output=export.n8np
n8n-cli package import --file=export.n8np --conflict-policy=fail
n8n-cli package import --file=export.n8np --project=<project-id> --workflow-id-policy=source --conflict-policy=skip

See n8n packages for a detailed overview of the available flags and what makes up a package.