ros/n8n-mcp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e6d0a2f83c39881e118877efe25427005770de7d
n8n-mcp/src/templates
History
czlonkowski 53d8c8452f fix: update database with 499 workflow templates and working FTS5 index 
- Database now contains 499 templates (was 399)
- FTS5 index properly populated with all template entries
- Fixed quote escaping in FTS5 queries to prevent syntax errors
- Verified FTS5 search returns correct results (162 for "webhook")
- Fixes template search in Docker deployments

The previous database had empty FTS5 tables causing search to fail.
This update ensures the FTS5 index is properly synchronized and
handles special characters in search queries.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-10 13:20:29 +02:00
..
README.md
feat: add n8n workflow templates as MCP tools
2025-06-20 00:02:09 +02:00
template-fetcher.ts
feat: expand template window from 6 months to 1 year and add robust fetcher
2025-06-20 00:52:26 +02:00
template-repository.ts
fix: update database with 499 workflow templates and working FTS5 index
2025-07-10 13:20:29 +02:00
template-service.ts
fix: make FTS5 optional for template search (fixes Claude Desktop compatibility)
2025-07-10 12:13:08 +02:00

README.md

n8n Templates Integration

This module provides integration with n8n.io's workflow templates, allowing AI agents to discover and use proven workflow patterns.

Features

  • API Integration: Connects to n8n.io's official template API
  • Fresh Templates: Only includes templates updated within the last 6 months
  • Manual Fetch: Templates are fetched separately from the main node database
  • Full Workflow JSON: Complete workflow definitions ready for import
  • Smart Search: Find templates by nodes, keywords, or task categories

Usage

Fetching Templates

npm run fetch:templates

This command will:

  1. Connect to n8n.io API
  2. Fetch all templates from the last 6 months
  3. Download complete workflow JSON for each template
  4. Store in local SQLite database
  5. Display progress and statistics

Testing

npm run test:templates

MCP Tools

The following tools are available via MCP:

  • list_node_templates(nodeTypes, limit) - Find templates using specific nodes
  • get_template(templateId) - Get complete workflow JSON
  • search_templates(query, limit) - Search by keywords
  • get_templates_for_task(task) - Get templates for common tasks

Task Categories

  • ai_automation - AI-powered workflows
  • data_sync - Database and spreadsheet synchronization
  • webhook_processing - Webhook handling workflows
  • email_automation - Email processing workflows
  • slack_integration - Slack bots and notifications
  • data_transformation - Data manipulation workflows
  • file_processing - File handling workflows
  • scheduling - Scheduled and recurring tasks
  • api_integration - External API connections
  • database_operations - Database CRUD operations

Implementation Details

Architecture

  • template-fetcher.ts - Handles API communication and rate limiting
  • template-repository.ts - Database operations and queries
  • template-service.ts - Business logic and MCP integration

Database Schema

Templates are stored in a dedicated table with:

  • Workflow metadata (name, description, author)
  • Node usage tracking
  • View counts for popularity
  • Complete workflow JSON
  • Creation/update timestamps
  • 6-month freshness constraint

API Endpoints Used

  • /api/templates/workflows - List all workflows
  • /api/templates/search - Search with pagination
  • /api/templates/workflows/{id} - Get specific workflow
  • /api/templates/search/filters - Available filters

Notes

  • Templates are NOT fetched during regular database rebuilds
  • Run fetch:templates manually when you need fresh templates
  • API rate limiting is implemented (200-500ms between requests)
  • Progress is shown during fetching for large datasets