n8n Nodes: Zep Integration

Supercharge your n8n workflows with long-term memory for your AI agents and assistants. This community node provides a complete integration with the powerful Zep Cloud v3 API, an open-source platform designed to give your AI a persistent memory and a rich understanding of its interactions.

As the official Zep nodes are now deprecated, this community-built node serves as a powerful, modern replacement, unlocking the full potential of Zep's latest features.

Zep is more than just a chat history log; it's a sophisticated memory layer that:

• 🧠 Remembers and Summarizes: Automatically creates summaries of conversations, allowing your AI to recall context from days, weeks, or months ago.
• 🕸️ Builds Knowledge Graphs: Extracts entities (people, products, places) and their relationships from conversations and documents, creating a knowledge graph that evolves over time.
• 🔍 Enables Powerful Search: Go beyond simple vector search with advanced, context-aware retrieval over conversation history and knowledge graphs.

This node is your key to building truly intelligent, personalized, and stateful AI applications directly within n8n.

Table of Contents

• Key Features
• Installation Guide
  • n8n Cloud
  • n8n Self-Hosted (Docker)
  • n8n Desktop
• Credentials Setup
• Operations Reference (All Endpoints Explained)
  • 👤 User
  • 💬 Thread
  • 🕸️ Graph
  • 📍 Node
  • ↔️ Edge
  • 🎬 Episode
  • 🏷️ Entity Type
  • ⏱️ Session
• Example Workflow: A Simple Memory-Powered Chatbot
• Compatibility
• Contributing
• License

Key Features

• Full Zep v3 API Coverage: Complete control over Users, Threads, Graphs, Nodes, Edges, Episodes, and Sessions.
• Effortless User Management: Create and manage users to associate memories and knowledge with specific individuals.
• Advanced Conversation Handling: Add messages individually or in batches, and retrieve rich, summarized context for your AI prompts.
• Knowledge Graph Mastery: Ingest unstructured text or structured data to automatically build a knowledge graph.
• Powerful Semantic Search: Utilize advanced search and reranking capabilities to find the most relevant information in your AI's memory.

Installation

n8n Cloud

If you’re using n8n Cloud, installing community nodes is the simplest:

1. From the n8n canvas, open the nodes panel by clicking the + button.
2. Search for Zep v3 in the community nodes section.
3. Click Install node to add the Zep node to your instance.

Note: On n8n Cloud, instance owners can choose to hide community nodes. If you don't see the node, please ensure the installation of community nodes is enabled in your Cloud Admin Panel.

Self-Hosted n8n / n8n Desktop

To install the Zep community node from the n8n Editor UI:

1. Open your n8n instance.
2. Go to Settings > Community Nodes.
3. Select Install.
4. Enter the npm package name: n8n-nodes-zep.
5. Agree to the risks of using community nodes and select Install.
6. The node will be installed, and your instance will restart. It is now available to use in your workflows.

Self-Hosted with Docker

For a permanent installation in a Docker environment, add the node as an environment variable:

1. Stop your n8n container.
2. Open your docker-compose.yml file (or the command you use to run n8n).
3. In the environment: section for your n8n service, add the following line:

   - N8N_CUSTOM_EXTENSIONS=n8n-nodes-zep
   

   If you have other community nodes listed in N8N_CUSTOM_EXTENSIONS, add this one to the comma-separated list.
4. Save the file and restart your n8n container: docker-compose up -d.

Credentials Setup

To connect to Zep, you need an API key.

1. Get a Zep API Key:

   • Sign up for a free account at Zep Cloud.
   • From your project dashboard, generate a new API Key and copy it.

2. Add Credentials to n8n:

   • In n8n, go to the Credentials section from the left-hand menu.
   • Click Add credential, search for Zep API, and select it.
   • Paste your API key into the API Key field.
   • Click Save.

You're all set! The Zep node will now be authenticated.

Operations Reference (All Endpoints Explained)

This node gives you access to the entire Zep v3 API. Operations are grouped by resource type.

Example Workflow: A Simple Memory-Powered Chatbot

This workflow demonstrates how to create a chatbot that remembers the conversation.

Nodes & Logic:

1. Webhook Node:

   • Receives a POST request with a userId and a message.
   • Example payload: { "userId": "user-jane-doe-456", "message": "What was the last thing I asked about?" }

2. Zep v3 Node (Add Message):

   • Resource: Thread
   • Operation: Add Messages to a Thread
   • Thread ID: Use an expression to create a consistent thread ID, e.g., {{ $json.body.userId }}-main. Zep automatically creates the thread on the first message.
   • Messages:
     • Role: user
     • Role Type: user
     • Content: {{ $json.body.message }}

3. Zep v3 Node (Get Context):

   • Resource: Thread
   • Operation: Get User Context
   • Thread ID: {{ $json.body.userId }}-main (same as above).
   • This node will output a context field containing a summary and relevant facts.

4. OpenAI Node (or any LLM):

   • Model: gpt-4-turbo
   • Prompt:

     You are a helpful assistant with a perfect memory of past conversations.
     
     Here is the relevant context from our previous discussions:
     ---
     {{ $json.context }}
     ---
     
     Based on that context, answer the user's latest question:
     {{ $('Zep v3').item.json.body.message }}
     

5. Webhook Response Node:

   • Returns the AI's generated response to the user.

This simple setup ensures your AI always has the necessary long-term context to provide intelligent, relevant, and personalized answers.

Compatibility

• n8n Version: 1.0.0 or higher.
• Zep API: Zep Cloud v3 API.

Contributing

This project was created by MTM Suhail to support the n8n community. Contributions, feature requests, and bug reports are highly welcome. Please open an issue or submit a pull request on the GitHub repository.