# Repository: Zie619/n8n-workflows # Stars: 53806 ## CLAUDE.md # n8n-workflows Repository # # Overview This repository contains a collection of n8n workflow automation files. n8n is a workflow automation tool that allows creating complex automations through a visual node-based interface. Each workflow is stored as a JSON file containing node definitions, connections, and configurations. # # Repository Structure ```text text text n8n-workflows/ ├── workflows/ # Main directory containing all n8n workflow JSON files │ ├── *.json # Individual workflow files ├── README.md # Repository documentation ├── claude.md # This file - AI assistant context └── [other files] # Additional configuration or documentation files ```text text text # # Workflow File Format Each workflow JSON file contains: - **name**: Workflow identifier - **nodes**: Array of node objects defining operations - **connections**: Object defining how nodes are connected - **settings**: Workflow-level configuration - **staticData**: Persistent data across executions - **tags**: Categorization tags - **createdAt/updatedAt**: Timestamps # # Common Node Types - **Trigger Nodes**: webhook, cron, manual - **Integration Nodes**: HTTP Request, database connectors, API integrations - **Logic Nodes**: IF, Switch, Merge, Loop - **Data Nodes**: Function, Set, Transform Data - **Communication**: Email, Slack, Discord, etc. # # Working with This Repository # # # For Analysis Tasks When analyzing workflows in this repository: 1. Parse JSON files to understand workflow structure 2. Examine node chains to determine functionality 3. Identify external integrations and dependencies 4. Consider the business logic implemented by node connections # # # For Documentation Tasks When documenting workflows: 1. Verify existing descriptions against actual implementation 2. Identify trigger mechanisms and schedules 3. List all external services and APIs used 4. Note data transformations and business logic 5. Highlight any error handling or retry mechanisms # # # For Modification Tasks When modifying workflows: 1. Preserve the JSON structure and required fields 2. Maintain node ID uniqueness 3. Update connections when adding/removing nodes 4. Test compatibility with n8n version requirements # # Key Considerations # # # Security - Workflow files may contain sensitive information in webhook URLs or API configurations - Credentials are typically stored separately in n8n, not in the workflow files - Be cautious with any hardcoded values or endpoints # # # Best Practices - Workflows should have clear, descriptive names - Complex workflows benefit from documentation nodes or comments - Error handling nodes improve reliability - Modular workflows (calling sub-workflows) improve maintainability # # # Common Patterns - **Data Pipeline**: Trigger → Fetch Data → Transform → Store/Send - **Integration Sync**: Cron → API Call → Compare → Update Systems - **Automation**: Webhook → Process → Conditional Logic → Actions - **Monitoring**: Schedule → Check Status → Alert if Issues # # Helpful Context for AI Assistants When assisting with this repository: 1. **Workflow Analysis**: Focus on understanding the business purpose by examining the node flow, not just individual nodes. 2. **Documentation Generation**: Create descriptions that explain what the workflow accomplishes, not just what nodes it contains. 3. **Troubleshooting**: Common issues include: - Incorrect node connections - Missing error handling - Inefficient data processing in loops - Hardcoded values that should be parameters 4. **Optimization Suggestions**: - Identify redundant operations - Suggest batch processing where applicable - Recommend error handling additions - Propose splitting complex workflows 5. **Code Generation**: When creating tools to analyze these workflows: - Handle various n8n format versions - Account for custom nodes - Parse expressions in node parameters - Consider node execution order # # Repository-Specific Information [Add any specific information about your workflows, naming conventions, or special considerations here] # # Version Compatibility - n8n version: [Specify the n8n version these workflows are compatible with] - Last updated: [Date of last major update] - Migration notes: [Any version-specific considerations] - - - [中文](./CLAUDE_ZH.md) ## README.md # n8n Workflow Collection
![n8n Workflows](https://img.shields.io/badge/n8n-Workflows-orange?style=for-the-badge&logo=n8n) ![Workflows](https://img.shields.io/badge/Workflows-4343+-blue?style=for-the-badge) ![Integrations](https://img.shields.io/badge/Integrations-365+-green?style=for-the-badge) ![License](https://img.shields.io/badge/License-MIT-purple?style=for-the-badge) [![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://www.buymeacoffee.com/zie619) ### The Ultimate Collection of n8n Automation Workflows **[Browse Online](https://zie619.github.io/n8n-workflows)** · **[Documentation](#documentation)** · **[Contributing](#contributing)** · **[License](#license)**
---
AI-BOM Logo

NEW: Scan Your n8n Workflows for AI Security Risks

AI-BOM Open Source First Ever
### Your workflows contain AI — do you know what's hiding in them? We built **[AI-BOM](https://github.com/Trusera/ai-bom)** because we scanned our own 4,343 workflows and found **hardcoded API keys, unauthenticated AI agents, and MCP clients connecting to unknown servers** — all invisible to existing security tools. **AI-BOM is the first and only tool that scans n8n workflows for AI security risks.** ```bash pip install ai-bom ai-bom scan ./workflows/ ``` One command finds every AI Agent node, LLM integration, MCP client, hardcoded credential, and dangerous tool combination — then gives you a risk score and a compliance-ready report. **EU AI Act deadline: August 2025.** You need an AI inventory. Get AI-BOM (free & open source) → AI-BOM Mascot
AI-BOM by Trusera
Securing the Agentic Service Mesh
What does AI-BOM detect in n8n workflows? (click to expand)
| Risk | Severity | What it finds | |------|----------|---------------| | **AI Agent nodes** | CRITICAL | Agents connected to LLMs with tool access — can execute code | | **Hardcoded credentials** | CRITICAL | API keys in workflow JSON instead of credential store | | **Dangerous tool combos** | CRITICAL | Agents with Code Execution + HTTP Request = RCE risk | | **MCP clients** | HIGH | Model Context Protocol connections to external servers | | **Unauthenticated webhooks** | HIGH | Webhook triggers exposed to the internet without auth | | **Agent chains** | HIGH | Execute Workflow linking agents without input validation | Beyond n8n, AI-BOM also scans **source code** (Python, JS, TS, Java, Go, Rust, Ruby), **Docker configs**, **cloud infrastructure** (Terraform, CloudFormation), and **network endpoints** — 21+ AI SDKs detected across 7 languages. Output formats: **CycloneDX SBOM** | **SARIF** (GitHub Code Scanning) | **HTML Dashboard** | **Markdown** | **JSON**
--- ## What's New ### Latest Updates (November 2025) - **Enhanced Security**: Full security audit completed, all CVEs resolved - **Docker Support**: Multi-platform builds for linux/amd64 and linux/arm64 - **GitHub Pages**: Live searchable interface at [zie619.github.io/n8n-workflows](https://zie619.github.io/n8n-workflows) - **Performance**: 100x faster search with SQLite FTS5 integration - **Modern UI**: Completely redesigned interface with dark/light mode --- ## Quick Access ### Use Online (No Installation) Visit **[zie619.github.io/n8n-workflows](https://zie619.github.io/n8n-workflows)** for instant access to: - **Smart Search** — Find workflows instantly - **15+ Categories** — Browse by use case - **Mobile Ready** — Works on any device - **Direct Downloads** — Get workflow JSONs instantly --- ## Features
### By The Numbers - **4,343** Production-Ready Workflows - **365** Unique Integrations - **29,445** Total Nodes - **15** Organized Categories - **100%** Import Success Rate ### Performance - **< 100ms** Search Response - **< 50MB** Memory Usage - **700x** Smaller Than v1 - **10x** Faster Load Times - **40x** Less RAM Usage
--- ## Local Installation ### Prerequisites - Python 3.9+ - pip (Python package manager) - 100MB free disk space ### Quick Start ```bash # Clone the repository git clone https://github.com/Zie619/n8n-workflows.git cd n8n-workflows # Install dependencies pip install -r requirements.txt # Start the server python run.py # Open in browser # http://localhost:8000 ``` ### Docker Installation ```bash # Using Docker Hub docker run -p 8000:8000 zie619/n8n-workflows:latest # Or build locally docker build -t n8n-workflows . docker run -p 8000:8000 n8n-workflows ``` --- ## Documentation ### API Endpoints | Endpoint | Method | Description | |----------|--------|-------------| | `/` | GET | Web interface | | `/api/search` | GET | Search workflows | | `/api/stats` | GET | Repository statistics | | `/api/workflow/{id}` | GET | Get workflow JSON | | `/api/categories` | GET | List all categories | | `/api/export` | GET | Export workflows | ### Search Features - **Full-text search** across names, descriptions, and nodes - **Category filtering** (Marketing, Sales, DevOps, etc.) - **Complexity filtering** (Low, Medium, High) - **Trigger type filtering** (Webhook, Schedule, Manual, etc.) - **Service filtering** (365+ integrations) --- ## Architecture ```mermaid graph LR A[User] --> B[Web Interface] B --> C[FastAPI Server] C --> D[SQLite FTS5] D --> E[Workflow Database] C --> F[Static Files] F --> G[Workflow JSONs] ``` ### Tech Stack - **Backend**: Python, FastAPI, SQLite with FTS5 - **Frontend**: Vanilla JS, Tailwind CSS - **Database**: SQLite with Full-Text Search - **Deployment**: Docker, GitHub Actions, GitHub Pages - **Security**: Trivy scanning, CORS protection, Input validation --- ## Repository Structure ``` n8n-workflows/ ├── workflows/ # 4,343 workflow JSON files │ └── [category]/ # Organized by integration ├── docs/ # GitHub Pages site ├── src/ # Python source code ├── scripts/ # Utility scripts ├── api_server.py # FastAPI application ├── run.py # Server launcher ├── workflow_db.py # Database manager └── requirements.txt # Python dependencies ``` --- ## Contributing We love contributions! Here's how you can help: ### Ways to Contribute - **Report bugs** via [Issues](https://github.com/Zie619/n8n-workflows/issues) - **Suggest features** in [Discussions](https://github.com/Zie619/n8n-workflows/discussions) - **Improve documentation** - **Submit workflow fixes** - **Star the repository** ### Development Setup ```bash # Fork and clone git clone https://github.com/YOUR_USERNAME/n8n-workflows.git # Create branch git checkout -b feature/amazing-feature # Make changes and test python run.py --debug # Commit and push git add . git commit -m "feat: add amazing feature" git push origin feature/amazing-feature # Open PR ``` --- ## Security ### Security Features - Path traversal protection - Input validation & sanitization - CORS protection - Rate limiting - Docker security hardening - Non-root container user - Regular security scanning ### Reporting Security Issues Please report security vulnerabilities to the maintainers via [Security Advisory](https://github.com/Zie619/n8n-workflows/security/advisories/new). --- ## License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. --- ## Support If you find this project helpful, please consider:
[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://www.buymeacoffee.com/zie619) [![Star on GitHub](https://img.shields.io/badge/Star%20on%20GitHub-181717?style=for-the-badge&logo=github)](https://github.com/Zie619/n8n-workflows)
---
![GitHub stars](https://img.shields.io/github/stars/Zie619/n8n-workflows?style=social) ![GitHub forks](https://img.shields.io/github/forks/Zie619/n8n-workflows?style=social) ![GitHub watchers](https://img.shields.io/github/watchers/Zie619/n8n-workflows?style=social) ![GitHub issues](https://img.shields.io/github/issues/Zie619/n8n-workflows) ![GitHub last commit](https://img.shields.io/github/last-commit/Zie619/n8n-workflows)
---
**Star us on GitHub — it motivates us a lot!** Made with care by [Zie619](https://github.com/Zie619) and [contributors](https://github.com/Zie619/n8n-workflows/graphs/contributors)
AI-BOM **[AI-BOM](https://github.com/Trusera/ai-bom)** — Discover every AI agent, model, and API hiding in your infrastructure.
Open source by **[Trusera](https://trusera.dev)** — Securing the Agentic Service Mesh.