Zep

Usage Instructions

Integrate Zep for long-term memory management. Create threads, add messages, retrieve context with AI-powered summaries and facts extraction.

Tools

`zep_create_thread`

Input

Parameter	Type	Required	Description
`threadId`	string	Yes	Unique identifier for the thread (e.g., "thread_abc123")
`userId`	string	Yes	User ID associated with the thread (e.g., "user_123")
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`threadId`	string	Thread identifier
`userId`	string	Associated user ID
`uuid`	string	Internal UUID
`createdAt`	string	Creation timestamp (ISO 8601)
`projectUuid`	string	Project UUID

`zep_get_threads`

Input

Parameter	Type	Required	Description
`pageSize`	number	No	No description
`pageNumber`	number	No	No description
`orderBy`	string	No	No description
`asc`	boolean	No	No description
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`threads`	array	Array of thread objects
↳ `threadId`	string	Thread identifier
↳ `userId`	string	Associated user ID
↳ `uuid`	string	Internal UUID
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `projectUuid`	string	Project UUID
↳ `metadata`	object	Custom metadata (dynamic key-value pairs)
`responseCount`	number	Number of items in this response
`totalCount`	number	Total number of items available

`zep_delete_thread`

Input

Parameter	Type	Required	Description
`threadId`	string	Yes	Thread ID to delete (e.g., "thread_abc123")
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`deleted`	boolean	Whether the thread was deleted

`zep_get_context`

Input

Parameter	Type	Required	Description
`threadId`	string	Yes	Thread ID to get context from (e.g., "thread_abc123")
`mode`	string	No	Context mode: "summary" (natural language) or "basic" (raw facts)
`minRating`	number	No	No description
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`context`	string	The context string (summary or basic mode)

`zep_get_messages`

Input

Parameter	Type	Required	Description
`threadId`	string	Yes	Thread ID to get messages from (e.g., "thread_abc123")
`limit`	number	No	No description
`cursor`	string	No	No description
`lastn`	number	No	No description
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`messages`	array	Array of message objects
↳ `uuid`	string	Message UUID
↳ `role`	string	Message role (user, assistant, system, tool)
↳ `roleType`	string	Role type (AI, human, tool)
↳ `content`	string	Message content
↳ `name`	string	Sender name
↳ `createdAt`	string	Timestamp (RFC3339 format)
↳ `metadata`	object	Message metadata (dynamic key-value pairs)
↳ `processed`	boolean	Whether message has been processed
`rowCount`	number	Number of rows returned
`totalCount`	number	Total number of items available

`zep_add_messages`

Input

Parameter	Type	Required	Description
`threadId`	string	Yes	Thread ID to add messages to (e.g., "thread_abc123")
`messages`	json	Yes	Array of message objects with role and content (e.g., [{"role": "user", "content": "Hello"}])
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`threadId`	string	Thread identifier
`added`	boolean	Whether messages were added successfully
`messageIds`	array	Array of added message UUIDs

`zep_add_user`

Input

Parameter	Type	Required	Description
`userId`	string	Yes	Unique identifier for the user (e.g., "user_123")
`email`	string	No	No description
`firstName`	string	No	No description
`lastName`	string	No	No description
`metadata`	json	No	Additional metadata as JSON object (e.g., {"key": "value"})
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`userId`	string	User identifier
`email`	string	User email address
`firstName`	string	User first name
`lastName`	string	User last name
`uuid`	string	Internal UUID
`createdAt`	string	Creation timestamp (ISO 8601)
`metadata`	object	User metadata (dynamic key-value pairs)

`zep_get_user`

Input

Parameter	Type	Required	Description
`userId`	string	Yes	User ID to retrieve (e.g., "user_123")
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`userId`	string	User identifier
`email`	string	User email address
`firstName`	string	User first name
`lastName`	string	User last name
`uuid`	string	Internal UUID
`createdAt`	string	Creation timestamp (ISO 8601)
`updatedAt`	string	Last update timestamp (ISO 8601)
`metadata`	object	User metadata (dynamic key-value pairs)

`zep_get_user_threads`

Input

Parameter	Type	Required	Description
`userId`	string	Yes	User ID to get threads for (e.g., "user_123")
`limit`	number	No	No description
`apiKey`	string	Yes	No description

Output

Parameter	Type	Description
`threads`	array	Array of thread objects
↳ `threadId`	string	Thread identifier
↳ `userId`	string	Associated user ID
↳ `uuid`	string	Internal UUID
↳ `createdAt`	string	Creation timestamp (ISO 8601)
↳ `updatedAt`	string	Last update timestamp (ISO 8601)
↳ `projectUuid`	string	Project UUID
↳ `metadata`	object	Custom metadata (dynamic key-value pairs)
`totalCount`	number	Total number of items available

On this page