n8n-cli — Claude Code skill: what it does, how to install
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.
no license 211 installs ★ 211,664 updated 2026-11-21
npx skills add n8n-io/n8n --skill n8n-cli -a claude-codeWhat n8n-cli 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.
What it helps with
- 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 for the agent
- 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
How to install n8n-cli
1Skills CLI (Vercel)
npx skills add n8n-io/n8n --skill n8n-cli -a claude-code2Manually: put the files in place
~/.claude/skills/n8n-cli/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/n8n-cli/
1Skills CLI (Vercel)
npx skills add n8n-io/n8n --skill n8n-cli -a codex2Manually: put the files in place
.agents/skills/n8n-cli/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add n8n-io/n8n --skill n8n-cli -a cursor2Manually: put the files in place
.cursor/skills/n8n-cli/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install n8n-io/n8n packages/@n8n/cli/skills/n8n-cli2Manually: put the files in place
.github/skills/n8n-cli/SKILL.md1Skills CLI (Vercel)
npx skills add n8n-io/n8n --skill n8n-cli -a gemini-cli2Platform CLI
gemini skills install https://github.com/n8n-io/n8n --path packages/@n8n/cli/skills/n8n-cliManually: put the files in place
.devin/skills/n8n-cli/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add n8n-io/n8n --skill n8n-cli -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about n8n-cli
How to install n8n-cli in Claude Code?
Run npx skills add n8n-io/n8n --skill n8n-cli -a claude-code in your terminal.
What does n8n-cli do?
It gives the coding agent terminal commands to operate an n8n instance. It handles workflows, inspects execution runs, updates data tables, and provisions secrets.
What is required to use n8n-cli?
You need the n8n-cli utility, an accessible n8n server URL, and an API key. Configure them using n8n-cli login or the N8N_URL and N8N_API_KEY variables.