Skip to main content

​
What is n8n?

n8n is a powerful workflow automation platform that allows you to connect different services and automate tasks. The Moorcheh n8n node enables you to integrate Moorcheh’s semantic search and AI capabilities directly into your n8n workflows.

​
Installation

​
Prerequisites

n8n Instance

Access to an n8n instance (cloud or self-hosted)

Moorcheh API Key

API key from console.moorcheh.ai

​
Install Moorcheh Node

Only the n8n instance owner can install and manage community nodes. All members of an n8n instance can use already installed community nodes in their workflows.
  • From n8n UI
  • Manual Installation
1

Open Nodes Panel

Go to the Canvas and open the nodes panel (select ’+’ or press Tab)
2

Search for Moorcheh

Search for “Moorcheh” in the nodes panelYou will see the Moorcheh node in the “More from the community” section at the bottom
3

View Node Details

Select the Moorcheh node to see all supported actions and features
4

Install

Select Install to add the node to your n8n instanceThis will enable all members to use it in their workflows
5

Start Using

Add the Moorcheh node to your workflows and configure your API key

​
Configuration

​
Set Up Credentials

1

Add Moorcheh Node

Add the Moorcheh node to your workflow
2

Configure Credentials

Click on the credentials dropdown and select “Create New”
3

Enter API Key

Enter your Moorcheh API key from console.moorcheh.ai
4

Test Connection

Test the connection to verify your API key is working

​
Available Operations

The Moorcheh n8n node supports the following operations:
  • Create Namespace: Create a new text or vector namespace
  • List Namespaces: Get all namespaces in your account
  • Delete Namespace: Remove a namespace and all its data
  • Upload Text: Upload text documents to a namespace
  • Upload Vectors: Upload vector embeddings
  • Get Documents: Retrieve specific documents by ID
  • Delete Data: Remove documents or vectors
  • Search: Perform semantic search across namespaces
  • Filter by Metadata: Use metadata filters for precise results
  • Multi-Namespace Search: Search across multiple namespaces
  • Generate Answer: Get AI-powered answers from your data
  • Choose AI Model: Select from 8 different AI models
  • Custom Prompts: Add custom instructions for responses
  • Chat History: Maintain conversation context

​
Use Cases

​
Document Processing Workflow

Automatically process incoming documents and make them searchable: 
Webhook → Extract Text → Moorcheh (Upload Text) → Slack Notification

​
Customer Support Automation

Create an automated support bot with knowledge base search: 
Gmail Trigger → Moorcheh (Search) → Moorcheh (Generate Answer) → Send Reply

​
Content Management

Sync and search your content across platforms: 
Airtable → Transform Data → Moorcheh (Upload Text) → Schedule

​
Data Integration

Connect multiple data sources for unified search: 
Google Drive → Extract Content → Moorcheh (Upload) → Index Complete

​
Example Workflows

​
Basic Search Workflow

  1. Trigger: Manual or webhook
  2. Moorcheh Node: Search operation
    • Namespace: my-documents
    • Query: {{$json["query"]}}
    • Top K: 5
  3. Output: Display search results

​
AI-Powered Q&A

  1. Trigger: HTTP request
  2. Moorcheh Node: Generate Answer
    • Namespace: knowledge-base
    • Query: {{$json["question"]}}
    • AI Model: anthropic.claude-sonnet-4-20250514-v1:0
  3. Response: Return AI-generated answer

​
Document Upload Pipeline

  1. Trigger: Google Drive (new file)
  2. Extract Text: Parse document content
  3. Moorcheh Node: Upload Text
    • Namespace: documents
    • Documents: Transform from previous step
  4. Notification: Send confirmation

​
Troubleshooting

Issue: Can’t find Moorcheh node in the nodes panelSolutions:
  • Ensure you have instance owner/admin permissions
  • Verify the package is installed: npm list n8n-nodes-moorcheh
  • Restart your n8n instance
  • Check that verified community nodes are enabled
Issue: API key authentication errorsSolutions:
  • Verify your API key is correct
  • Ensure the key hasn’t been revoked
  • Check that you’re using the header name x-api-Key
  • Generate a new API key if needed
Issue: Requests timing outSolutions:
  • Check your internet connection
  • Verify n8n can access https://api.moorcheh.ai
  • Check firewall settings
  • Increase timeout settings if needed
Issue: Data upload operations failingSolutions:
  • Verify namespace exists
  • Check data format matches requirements
  • Ensure file size is under 10MB
  • Validate vector dimensions match namespace

​
Best Practices

Error Handling

Always add error handling nodes to catch and log failures

Rate Limiting

Implement delays between batch operations to avoid rate limits

Secure Credentials

Use n8n’s credential management, never hardcode API keys

Test Workflows

Test with small datasets before running on production data

​
Community & Support

NPM Package

View package details and documentation

n8n Community

Join the n8n community forum

Moorcheh Support

Get help from our team

​
Next Steps

Quick Start

Learn Moorcheh basics

API Reference

Explore all API endpoints

Other Integrations

LangChain, LlamaIndex, and more

n8n Documentation

Learn more about n8n