---
title: "Zep integration for LuumenAI"
url: "https://www.luumen.ai/integrations/zep/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Zep integration for LuumenAI

Read agent memory, sessions, and graphs — then write back with approval

## What LuumenAI can do with Zep

LuumenAI connects to Zep with an API token and exposes 41 tools (22 read-only · 14 write · 5 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 41 tools (22 read-only · 14 write · 5 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: AI & automation

## About Zep with LuumenAI

Zep holds the memory behind your agents: sessions, threads, messages, and the knowledge graphs built from them. Luumen reads that history directly — session memory, thread context, node edges, task status — so you can see what an agent actually knew. Changes, like adding a fact triple or a new thread, are previewed and sent for approval first. Connects with an API key.

## Example tools

Read-only (22 in total):

- `ZEP_GET_EDGE` — Retrieve a specific edge by its UUID from the Zep knowledge graph.
- `ZEP_GET_GRAPH_BY_ID` — Retrieve a graph by its unique identifier from Zep.
- `ZEP_GET_GROUP` — Retrieve a group by ID from Zep.
- `ZEP_GET_NODE_EDGES` — Retrieve all entity edges for a specific node in the Zep knowledge graph.
- `ZEP_GET_PROJECT_INFO` — Retrieve project information based on the provided API key.
- `ZEP_GET_SESSION` — Retrieve a session by its unique identifier from Zep.
- `ZEP_GET_SESSION_MEMORY` — Retrieve memory for a given session including relevant facts and entities.
- `ZEP_GET_SESSION_MESSAGE` — Retrieve a specific message by UUID from a Zep session.

Write and destructive (19 in total, subject to configured approval policy):

- `ZEP_ADD_FACT_TRIPLE` — Add a manually specified fact triple (subject-predicate-object) to the Zep knowledge graph.
- `ZEP_ADD_SESSION_MEMORY` — Add memory messages to a specified Zep session.
- `ZEP_ADD_THREAD_MESSAGES` — Add chat messages to a thread in Zep and ingest them into the user knowledge graph.
- `ZEP_CLONE_GRAPH` — Clone a user or group graph with new identifiers in Zep.
- `ZEP_CREATE_GRAPH` — Create a new graph by adding data to Zep.
- `ZEP_CREATE_GROUP` — Create a new group in Zep for multi-user graph management.
- `ZEP_CREATE_SESSION` — Create a new session in Zep for storing conversation memory.
- `ZEP_CREATE_THREAD` — Create a new thread in Zep for a specific user.

## Frequently asked questions

### How does LuumenAI connect to Zep?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Zep on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

Every call to Zep — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/zep/