# n8n-cli

n8n-cli is a Claude Code skill that controls an n8n instance via its REST API. Runs when handling workflow automation, credential setup, execution checks, or CLI instance tasks.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 211 installs · ★ 211664 repo stars
- Author: n8n-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/n8n-io/n8n/tree/HEAD/packages/@n8n/cli/skills/n8n-cli/SKILL.md
- Updated: 2026-11-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/n8n-cli

## What it does

The skill manages an n8n deployment through the `n8n-cli` command-line tool. It lists and filters workflows by status or tags, retrieves full graph definitions, and imports updates directly from JSON files or standard input. Output piped to another process switches to JSON automatically for easy parsing.

It handles execution monitoring, node I/O inspections, and retries for failed tasks. The tool also covers project spaces, user roles, environment variables, credentials metadata, and custom data tables. Environments can be promoted between instances using connected Git repositories.

Commands require network access to an active n8n instance and a valid API key. Credentials can be passed interactively with `n8n-cli login`, set in `N8N_URL` and `N8N_API_KEY` environment variables, or provided via CLI flags.

## Requirements
- Works with: n8n

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add n8n-io/n8n --skill n8n-cli -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/n8n-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/n8n-cli/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add n8n-io/n8n --skill n8n-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/n8n-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add n8n-io/n8n --skill n8n-cli -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/n8n-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install n8n-io/n8n packages/@n8n/cli/skills/n8n-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/n8n-cli/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add n8n-io/n8n --skill n8n-cli -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/n8n-io/n8n --path packages/@n8n/cli/skills/n8n-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/n8n-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add n8n-io/n8n --skill n8n-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/n8n-io/n8n/tree/HEAD/packages/@n8n/cli/skills/n8n-cli/SKILL.md

## When to use it
- inspect error logs and rerun failed workflow executions
- deploy or update n8n workflows from local JSON files
- inspect credential schemas and configure API connections
- synchronize projects between instances using Git providers

## Example prompts
- List all active n8n workflows with the production tag
- Find failed executions and retry the most recent one
- Create an Inventory data table and insert rows from rows.json

## Similar
- [n8n-expression-syntax](https://affpapa.org/en/nevibecode/skills/n8n-expression-syntax.md) — skill · 7100 installs
- [n8n-Management](https://affpapa.org/en/nevibecode/mcp/n8n-management.md) — MCP server · 171 installs
- [n8n-workflow](https://affpapa.org/en/nevibecode/skills/n8n-workflow.md) — skill · 5000 installs
- [n8n-error-handling-official](https://affpapa.org/en/nevibecode/skills/n8n-error-handling-official.md) — skill · 2500 installs
- [using-n8n-skills-official](https://affpapa.org/en/nevibecode/skills/using-n8n-skills-official.md) — skill · 2400 installs

From the same set: [n8n-io/n8n](https://affpapa.org/en/nevibecode/by/n8n-io/n8n.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
