n8n MCP Skills

Expert guides and best practices for using n8n MCP tools effectively with AI agents.

Pro Tip: Skills are comprehensive guides designed to help AI agents (like Claude) use n8n MCP tools more effectively. Each skill provides patterns, examples, and mistake-avoidance strategies.

---

Direct Access to Skills

All skills are available as markdown files on GitHub for easy access by AI agents:

Skills Repository URL:

https://github.com/your-org/n8n-mcp-bridge/tree/main/packages/mcp-server/docs/skills

Replace with your actual repository URL

---

Available Skills

---

1. n8n MCP Tools Expert

Master guide for all n8n MCP tools

Essential resource for AI agents working with n8n MCP Bridge.

Contents

• SKILL.md - Complete tool guide
• SEARCH_GUIDE.md - Node discovery patterns
• VALIDATION_GUIDE.md - Validation strategies
• WORKFLOW_GUIDE.md - Workflow management
• README.md - Overview

Topics Covered

• Tool selection guide (which tool to use when)
• Common patterns and workflows
• Performance optimization
• Mistake avoidance
• Best practices

Direct Links

• View on GitHub
• Download ZIP

---

2. n8n Code: JavaScript

JavaScript Code node patterns and best practices

Learn how to use JavaScript Code nodes effectively in n8n workflows.

Contents

• BUILTIN_FUNCTIONS.md - n8n built-in functions ($input, $json, $binary)
• COMMON_PATTERNS.md - JavaScript patterns
• DATA_ACCESS.md - Data access methods
• ERROR_PATTERNS.md - Common JavaScript errors
• SKILL.md - Complete guide

Topics Covered

• n8n-specific functions
• Data transformation patterns
• Common mistakes and how to avoid them
• Debugging techniques

Direct Links

• View on GitHub

---

3. n8n Code: Python

Python Code node patterns and best practices

Learn how to use Python Code nodes effectively in n8n workflows.

Contents

• COMMON_PATTERNS.md - Python patterns
• DATA_ACCESS.md - How to access _input, _json
• ERROR_PATTERNS.md - Common Python errors
• STANDARD_LIBRARY.md - Standard library usage
• SKILL.md - Complete guide

Topics Covered

• Python standard library in n8n context
• Data access patterns
• Common mistakes
• Best practices

Direct Links

• View on GitHub

---

4. n8n Expression Syntax

Master n8n's expression language

Learn how to use expressions like {{ $json.field }} for dynamic workflows.

Contents

• SKILL.md - Complete expression guide
• COMMON_MISTAKES.md - Mistakes to avoid
• EXAMPLES.md - Real-world examples
• README.md - Quick reference

Topics Covered

• Expression syntax ({{ ... }})
• Expression functions (date, string, math)
• Data references ($json, $input, $node)
• Common mistakes (missing braces, incorrect references)

Direct Links

• View on GitHub

---

5. n8n Node Configuration

Node configuration patterns and requirements

Understand how to configure nodes correctly for different operations.

Contents

• SKILL.md - Configuration guide
• DEPENDENCIES.md - Node dependencies (which fields depend on others)
• OPERATION_PATTERNS.md - Operation-specific configs
• README.md - Quick reference

Topics Covered

• Required parameters for operations
• Node dependencies
• Operation-specific patterns
• Configuration validation

Direct Links

• View on GitHub

---

6. n8n Validation Expert

Validation error catalog and solutions

Comprehensive guide to validation errors and how to fix them.

Contents

• SKILL.md - Validation guide
• ERROR_CATALOG.md - Common errors + fixes
• FALSE_POSITIVES.md - Known false positives
• README.md - Quick reference

Topics Covered

• Common validation errors
• How to fix each error type
• False positive guide
• Validation profile selection (minimal, runtime, ai-friendly, strict)

Direct Links

• View on GitHub

---

7. n8n Workflow Patterns

Workflow architecture patterns and examples

Real-world workflow patterns for common use cases.

Contents

• ai_agent_workflow.md - AI agent patterns
• database_operations.md - Database patterns
• http_api_integration.md - API integration
• webhook_processing.md - Webhook handling
• scheduled_tasks.md - Cron/scheduled workflows
• SKILL.md - Overview

Topics Covered

• AI agent workflow architecture
• Database CRUD operations
• HTTP API integration patterns
• Webhook processing
• Scheduled tasks and cron
• Error handling patterns

Direct Links

• View on GitHub

---

How to Use Skills

---

Skill Format

Each skill follows a consistent structure:

• SKILL.md - Main comprehensive guide
• README.md - Quick reference and overview
• Specialized guides - Topic-specific deep dives
• Examples - Real-world usage patterns
• Error catalogs - Common issues and solutions

---

Related Documentation

---

Open Source: All skills are open source and available on GitHub. Contributions are welcome!

---

Last Updated: 2026-01-24 Skills Count: 7 categories, 32 files License: MIT