How do I install the N8n skill?

Run npx skillmds@latest add tomevault-io/n8n-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with N8n?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

N8n by tomevault-io — Agent Skill

Name: N8n
Author: tomevault-io

N8n

Manage n8n workflows and automations via API. Use when working with n8n workflows, executions, or automation tasks - listing workflows, activating/deactivating, checking execution status, manually triggering workflows, or debugging automation issues. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

n8n Workflow Management

Interact with n8n automation platform via REST API.

Setup

First-time setup:

API key must be stored in environment:

export N8N_API_KEY="your-api-key-here"

Verify connection:

python3 scripts/n8n_api.py list-workflows --pretty

For persistent storage, add to ~/.bashrc or ~/.zshrc:

echo 'export N8N_API_KEY="your-key"' >> ~/.bashrc

Quick Reference

List Workflows

python3 scripts/n8n_api.py list-workflows --pretty
python3 scripts/n8n_api.py list-workflows --active true --pretty

Get Workflow Details

python3 scripts/n8n_api.py get-workflow --id <workflow-id> --pretty

Activate/Deactivate

python3 scripts/n8n_api.py activate --id <workflow-id>
python3 scripts/n8n_api.py deactivate --id <workflow-id>

Executions

# List recent executions
python3 scripts/n8n_api.py list-executions --limit 10 --pretty

# Get execution details
python3 scripts/n8n_api.py get-execution --id <execution-id> --pretty

# Filter by workflow
python3 scripts/n8n_api.py list-executions --id <workflow-id> --limit 20 --pretty

Manual Execution

# Trigger workflow
python3 scripts/n8n_api.py execute --id <workflow-id>

# With data
python3 scripts/n8n_api.py execute --id <workflow-id> --data '{"key": "value"}'

Python API

For programmatic access:

from scripts.n8n_api import N8nClient

client = N8nClient()

# List workflows
workflows = client.list_workflows(active=True)

# Get workflow
workflow = client.get_workflow('workflow-id')

# Activate/deactivate
client.activate_workflow('workflow-id')
client.deactivate_workflow('workflow-id')

# Executions
executions = client.list_executions(workflow_id='workflow-id', limit=10)
execution = client.get_execution('execution-id')

# Execute workflow
result = client.execute_workflow('workflow-id', data={'key': 'value'})

Common Tasks

Debug Failed Workflows

List recent executions with failures
Get execution details to see error
Check workflow configuration
Deactivate if needed

Monitor Workflow Health

List active workflows
Check recent execution status
Review error patterns

Workflow Management

List all workflows
Review active/inactive status
Activate/deactivate as needed
Delete old workflows

API Reference

For detailed API documentation, see references/api.md.

Troubleshooting

Authentication error:

Verify N8N_API_KEY is set: echo $N8N_API_KEY
Check API key is valid in n8n UI

Connection error:

Check N8N_BASE_URL if using custom URL

Command errors:

Use --pretty flag for readable output
Check --id is provided when required
Validate JSON format for --data parameter

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: n8n-2description: Manage n8n workflows and automations via API. Use when working with n8n workflows, executions, or automation tasks - listing workflows, activating/deactivating, checking execution status, manually triggering workflows, or debugging automation issues. Use when this capability is needed.---# n8n Workflow ManagementInteract with n8n automation platform via REST API.## Setup**First-time setup:**1. API key must be stored in environment:```bashexport N8N_API_KEY="your-api-key-here"```2. Verify connection:```bashpython3 scripts/n8n_api.py list-workflows --pretty```For persistent storage, add to `~/.bashrc` or `~/.zshrc`:```bashecho 'export N8N_API_KEY="your-key"' >> ~/.bashrc```## Quick Reference### List Workflows```bashpython3 scripts/n8n_api.py list-workflows --prettypython3 scripts/n8n_api.py list-workflows --active true --pretty```### Get Workflow Details```bashpython3 scripts/n8n_api.py get-workflow --id <workflow-id> --pretty```### Activate/Deactivate```bashpython3 scripts/n8n_api.py activate --id <workflow-id>python3 scripts/n8n_api.py deactivate --id <workflow-id>```### Executions```bash# List recent executionspython3 scripts/n8n_api.py list-executions --limit 10 --pretty# Get execution detailspython3 scripts/n8n_api.py get-execution --id <execution-id> --pretty# Filter by workflowpython3 scripts/n8n_api.py list-executions --id <workflow-id> --limit 20 --pretty```### Manual Execution```bash# Trigger workflowpython3 scripts/n8n_api.py execute --id <workflow-id># With datapython3 scripts/n8n_api.py execute --id <workflow-id> --data '{"key": "value"}'```## Python APIFor programmatic access:```pythonfrom scripts.n8n_api import N8nClientclient = N8nClient()# List workflowsworkflows = client.list_workflows(active=True)# Get workflowworkflow = client.get_workflow('workflow-id')# Activate/deactivateclient.activate_workflow('workflow-id')client.deactivate_workflow('workflow-id')# Executionsexecutions = client.list_executions(workflow_id='workflow-id', limit=10)execution = client.get_execution('execution-id')# Execute workflowresult = client.execute_workflow('workflow-id', data={'key': 'value'})```## Common Tasks### Debug Failed Workflows1. List recent executions with failures2. Get execution details to see error3. Check workflow configuration4. Deactivate if needed### Monitor Workflow Health1. List active workflows2. Check recent execution status3. Review error patterns### Workflow Management1. List all workflows2. Review active/inactive status3. Activate/deactivate as needed4. Delete old workflows## API ReferenceFor detailed API documentation, see [references/api.md](references/api.md).## Troubleshooting**Authentication error:**- Verify N8N_API_KEY is set: `echo $N8N_API_KEY`- Check API key is valid in n8n UI**Connection error:**- Check N8N_BASE_URL if using custom URL**Command errors:**- Use `--pretty` flag for readable output- Check `--id` is provided when required- Validate JSON format for `--data` parameter---> Converted and distributed by [TomeVault](https://tomevault.io/claim/demerzels-lab) — claim your Tome and manage your conversions.

Frequently asked questions

N8n