n8n-nodes-zep-memory

This is an n8n community node for Zep Memory - a memory service for AI applications that enables persistent conversation memory for LLM workflows.

Zep provides long-term memory for AI assistants, chatbots, and other applications. It offers conversation history management, semantic search, and intelligent memory features.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Go to Settings > Community Nodes.
2. Select Install.
3. Enter n8n-nodes-zep-memory in Enter npm package name.
4. Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a public source.
5. Select Install.

After installing the node, you can use it like any other node in n8n.

Manual installation

To get started install the package in your n8n root directory:

npm install n8n-nodes-zep-memory

For Docker-based deployments add the following line before the font installation command in your n8n Dockerfile:

RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-zep-memory

Configuration

You'll need to configure the Zep Memory API credentials:

1. Base URL: Your Zep instance URL (e.g., https://api.getzep.com for Zep Cloud)
2. API Key: Your Zep API key

Operations

This node supports the following resources and operations:

Session

• Create: Create a new conversation session
• Get: Retrieve session details
• Update: Update session metadata
• Delete: Delete a session
• List: List all sessions

Memory

• Get: Retrieve memory/summary for a session
• Delete: Clear memory for a session

Message

• Add: Add messages to a session
• Get: Retrieve messages from a session
• Search: Search messages using semantic search

Usage Examples

Creating a Session

{
  "resource": "session",
  "operation": "create",
  "sessionId": "user-123-session",
  "userId": "user-123",
  "metadata": {
    "metadataValues": [
      {"key": "customer_id", "value": "12345"},
      {"key": "channel", "value": "web"}
    ]
  }
}

Adding Messages

{
  "resource": "message", 
  "operation": "add",
  "sessionId": "user-123-session",
  "messages": {
    "messageValues": [
      {"role": "user", "content": "Hello, I need help with my order"},
      {"role": "assistant", "content": "I'd be happy to help you with your order. Can you provide your order number?"}
    ]
  }
}

Searching Messages

{
  "resource": "message",
  "operation": "search", 
  "sessionId": "user-123-session",
  "query": "order status shipping",
  "searchLimit": 5
}

Resources

• Zep Documentation
• Zep API Reference
• n8n Community Nodes Documentation

Version history

• 0.1.0 - Initial release with core Zep Memory functionality

License

MIT