ros/n8n-mcp
1
0
Fork 0
mirror of https://github.com/czlonkowski/n8n-mcp.git synced 2026-01-30 06:22:04 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
e522aec08c40a7635d80363c9e9375eda3d581b3
n8n-mcp/src/templates
History
czlonkowski 710f054b93 chore: update n8n to v1.114.3 and optimize template fetching 
Updates:
- Updated n8n from 1.113.3 to 1.114.3
- Updated n8n-core from 1.112.1 to 1.113.1
- Updated n8n-workflow from 1.110.0 to 1.111.0
- Updated @n8n/n8n-nodes-langchain from 1.112.2 to 1.113.1
- Rebuilt node database with 536 nodes
- Updated template database (2647 → 2653, +6 new templates)
- Sanitized 24 templates to remove API tokens

Performance Improvements:
- Optimized template update to fetch only last 2 weeks
- Reduced update time from 10+ minutes to ~60 seconds
- Added getMostRecentTemplateDate() to TemplateRepository
- Modified TemplateFetcher to support date-based filtering
- Update mode now fetches templates since (most_recent - 14 days)

All tests passing (933 unit, 249 integration)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-07 13:44:34 +02:00
..
batch-processor.ts
fix: improve batch job monitoring with 1-minute polling
2025-09-30 10:46:28 +02:00
metadata-generator.ts
feat: add incremental template updates and fix metadata generation
2025-09-30 09:59:42 +02:00
README.md
feat: add n8n workflow templates as MCP tools
2025-06-20 00:02:09 +02:00
template-fetcher.ts
chore: update n8n to v1.114.3 and optimize template fetching
2025-10-07 13:44:34 +02:00
template-repository.ts
chore: update n8n to v1.114.3 and optimize template fetching
2025-10-07 13:44:34 +02:00
template-service.ts
chore: update n8n to v1.114.3 and optimize template fetching
2025-10-07 13:44:34 +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