n8n-nodes-knotie

This is an n8n community node that allows you to connect to 100+ tools through Knotie AI Pro integration platform.

n8n is a fair-code licensed workflow automation platform.

Features

• 100+ Tools: Connect to Gmail, Google Calendar, Slack, Notion, HubSpot, Salesforce, and many more
• Single Node: One node to rule them all - no need to install separate nodes for each service
• Dynamic Tool Loading: Tools are loaded dynamically based on your customer's integrations
• Secure Authentication: Uses Knotie AI Pro's secure token-based authentication
• Real-time Schema: Tool parameters are loaded dynamically with proper validation

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install
3. Enter n8n-nodes-knotie as the package name
4. Select Install

Manual Installation

# Navigate to your n8n installation
cd ~/.n8n

# Install the package
npm install n8n-nodes-knotie

Prerequisites

1. Knotie AI Pro Account: You need a partner account at Knotie AI Pro
2. Customer with Integrations: Your customer must have connected their tools through the Knotie portal
3. N8N Token: Generate an N8N token from your partner dashboard

Configuration

Step 1: Generate N8N Token

1. Log into your Knotie AI Pro partner dashboard
2. Go to AI Agents → N8N Automation
3. Click N8N Token Manager
4. Select your customer and create a new token
5. Copy the generated token (it won't be shown again)

Step 2: Configure Credentials

1. In n8n, go to Credentials
2. Create new Knotie API credentials
3. Enter your N8N token
4. Test the connection

Step 3: Use the Node

1. Add a Knotie node to your workflow
2. Select your Knotie API credentials
3. Choose a tool from the dropdown (tools are loaded based on your customer's integrations)
4. Enter tool parameters in JSON format in the "Tool Parameters" field
5. Execute your workflow

Usage Examples

Send Email via Gmail

Tool: gmail:GMAIL_SEND_EMAIL
Parameters:

{
  "to": "user@example.com",
  "subject": "Hello from N8N!",
  "body": "This email was sent via Knotie AI Pro integration."
}

Create Google Calendar Event

Tool: googlecalendar:GOOGLECALENDAR_CREATE_EVENT
Parameters:

{
  "summary": "Team Meeting",
  "start_datetime": "2024-01-15T14:00:00",
  "end_datetime": "2024-01-15T15:00:00",
  "timezone": "America/New_York"
}

Send Slack Message

Tool: slack:SLACK_SEND_MESSAGE
Parameters:

{
  "channel": "#general",
  "text": "Workflow completed successfully!"
}

Available Tools

The available tools depend on what your customer has connected in their Knotie portal. Common integrations include:

• Communication: Gmail, Outlook, Slack, Microsoft Teams
• Calendar: Google Calendar, Outlook Calendar
• CRM: HubSpot, Salesforce, Pipedrive
• Productivity: Notion, Airtable, Trello, Asana
• E-commerce: Shopify, WooCommerce
• And many more...

Error Handling

The node includes comprehensive error handling:

• Invalid Token: Check your token and regenerate if needed
• Tool Not Found: Ensure the tool is available in your customer's integrations
• Parameter Validation: Check that all required parameters are provided
• Rate Limiting: The node respects API rate limits

🔧 Development

Building the Node

npm run build

Testing Locally

npm link
# In your N8N installation directory
npm link n8n-knotie-node

Adding New Tool Forms

Option 1: Using CLI Tool (Recommended)

# Create a new app form definition
node scripts/manage-forms.js create-app discord "Discord" "Team communication tools"

# List all existing app forms
node scripts/manage-forms.js list-apps

# Validate all form definitions
node scripts/manage-forms.js validate

# Get statistics about form coverage
node scripts/manage-forms.js stats

Option 2: Manual Creation

1. Create app form file in nodes/Knotie/forms/apps/yourapp.ts:

import { AppFormRegistry } from '../index';

const yourappForms: AppFormRegistry = {
  appName: 'yourapp',
  displayName: 'Your App',
  description: 'Tools for Your App',
  tools: [
    {
      toolId: 'yourapp:TOOL_NAME',
      displayName: 'Tool Display Name',
      description: 'Tool description',
      fields: [
        {
          displayName: 'Field Name <span style="color: red;">*</span>',
          name: 'field_name',
          type: 'string',
          required: true,
          default: '',
          placeholder: 'Enter value...',
          description: 'Field description',
        },
        // Add more fields...
      ],
    },
    // Add more tools...
  ],
};

export default yourappForms;

2. Update the form registry in nodes/Knotie/forms/index.ts to include your app
3. Rebuild and restart N8N

Architecture Benefits

• Scalable: Each app has its own file (ready for 5000+ tools)
• Maintainable: Easy to find and update specific app forms
• Performance: Forms loaded on-demand, not all at once
• Team-friendly: Multiple developers can work on different apps
• Validation: Built-in validation and CLI tools

Support

• Documentation: docs.knotie-ai.pro/n8n
• Support: support@knotie-ai.pro
• Community: Join our Discord

License

MIT

Version History

3.0.1 - KNOTIE AI BRANDING UPDATE 🎨

• NEW: Updated Knotie AI branding - proper logo and visual identity
• NEW: Enhanced icon design - gradient background with Knotie brand colors
• NEW: Improved node display - "Knotie AI" name with app-tool subtitle format
• NEW: Brand consistency - updated descriptions and package information
• IMPROVED: Professional appearance suitable for enterprise use

3.0.0 - SCALABLE ARCHITECTURE FOR 5000+ TOOLS 🏗️

• NEW: App-based form organization - separate files for each app (Gmail, Slack, GitHub, etc.)
• NEW: Dynamic form loading - forms loaded on-demand for better performance
• NEW: CLI management tool - scripts/manage-forms.js for creating and managing forms
• NEW: Form validation system - built-in validation for form definitions
• NEW: Statistics and monitoring - track form coverage across apps
• NEW: Template system - easy scaffolding for new app forms
• BREAKING: Restructured form definitions (old single-file approach removed)
• SCALABLE: Ready for 5000+ tools with maintainable architecture

2.1.0 - APP-BASED SELECTION & VISUAL IMPROVEMENTS ✨

• NEW: Two-step selection: Choose App first, then Tool (much easier navigation!)
• NEW: Enhanced UI indicators: Tools with custom forms show ✨ icon
• NEW: Red asterisks for required parameters (better visibility)
• NEW: Framework for form definitions (easy to add new tools)
• NEW: Maintainable tool registry with custom form support
• IMPROVED: Better organization - users select by app category first
• IMPROVED: Visual distinction between enhanced and standard tools

2.0.0 - MAJOR UI OVERHAUL 🎉

• NEW: Individual form fields for Gmail Send Email (recipient, subject, body, etc.)
• NEW: Individual form fields for Slack Send Message (channel, text)
• NEW: Smart parameter parsing (arrays, JSON objects, comma-separated values)
• NEW: Type-specific UI controls (boolean toggles, multi-line text areas)
• NEW: Required field validation with clear indicators
• NEW: Fallback to generic parameters for unsupported tools
• BREAKING: Completely redesigned parameter input system
• IMPROVED: Much more user-friendly experience for common tools

1.1.0

• NEW: JSON-based parameter input for better flexibility
• NEW: Improved credential testing with timeout handling
• NEW: Better error messages and validation
• NEW: Help text with common parameter examples
• IMPROVED: Dynamic URL resolution based on registry URL
• IMPROVED: Better parameter parsing and validation

1.0.0

• Initial release
• Support for 100+ tools
• Dynamic tool loading
• Secure token authentication