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`

Start a new conversation thread in Zep

Input

Parameter	Type	Required	Description
`threadId`	string	Yes	Unique identifier for the thread
`userId`	string	Yes	User ID associated with the thread
`apiKey`	string	Yes	Your Zep API key

Output

Parameter	Type	Description
`threadId`	string	The thread ID
`userId`	string	The user ID
`uuid`	string	Internal UUID
`createdAt`	string	Creation timestamp
`projectUuid`	string	Project UUID

`zep_get_threads`

List all conversation threads

Input

Parameter	Type	Required	Description
`pageSize`	number	No	Number of threads to retrieve per page
`pageNumber`	number	No	Page number for pagination
`orderBy`	string	No	Field to order results by (created_at, updated_at, user_id, thread_id)
`asc`	boolean	No	Order direction: true for ascending, false for descending
`apiKey`	string	Yes	Your Zep API key

Output

Parameter	Type	Description
`threads`	array	Array of thread objects
`responseCount`	number	Number of threads in this response
`totalCount`	number	Total number of threads available

`zep_delete_thread`

Delete a conversation thread from Zep

Input

Parameter	Type	Required	Description
`threadId`	string	Yes	Thread ID to delete
`apiKey`	string	Yes	Your Zep API key

Output

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

`zep_get_context`

Retrieve user context from a thread with summary or basic mode

Input

Parameter	Type	Required	Description
`threadId`	string	Yes	Thread ID to get context from
`mode`	string	No	Context mode: "summary" (natural language) or "basic" (raw facts)
`minRating`	number	No	Minimum rating by which to filter relevant facts
`apiKey`	string	Yes	Your Zep API key

Output

Parameter	Type	Description
`context`	string	The context string (summary or basic)
`facts`	array	Extracted facts
`entities`	array	Extracted entities
`summary`	string	Conversation summary

`zep_get_messages`

Retrieve messages from a thread

Input

Parameter	Type	Required	Description
`threadId`	string	Yes	Thread ID to get messages from
`limit`	number	No	Maximum number of messages to return
`cursor`	string	No	Cursor for pagination
`lastn`	number	No	Number of most recent messages to return (overrides limit and cursor)
`apiKey`	string	Yes	Your Zep API key

Output

Parameter	Type	Description
`messages`	array	Array of message objects
`rowCount`	number	Number of messages in this response
`totalCount`	number	Total number of messages in the thread

`zep_add_messages`

Add messages to an existing thread

Input

Parameter	Type	Required	Description
`threadId`	string	Yes	Thread ID to add messages to
`messages`	json	Yes	Array of message objects with role and content
`apiKey`	string	Yes	Your Zep API key

Output

Parameter	Type	Description
`context`	string	Updated context after adding messages
`messageIds`	array	Array of added message UUIDs
`threadId`	string	The thread ID

`zep_add_user`

Create a new user in Zep

Input

Parameter	Type	Required	Description
`userId`	string	Yes	Unique identifier for the user
`email`	string	No	User email address
`firstName`	string	No	User first name
`lastName`	string	No	User last name
`metadata`	json	No	Additional metadata as JSON object
`apiKey`	string	Yes	Your Zep API key

Output

Parameter	Type	Description
`userId`	string	The user ID
`email`	string	User email
`firstName`	string	User first name
`lastName`	string	User last name
`uuid`	string	Internal UUID
`createdAt`	string	Creation timestamp
`metadata`	object	User metadata

`zep_get_user`

Retrieve user information from Zep

Input

Parameter	Type	Required	Description
`userId`	string	Yes	User ID to retrieve
`apiKey`	string	Yes	Your Zep API key

Output

Parameter	Type	Description
`userId`	string	The user ID
`email`	string	User email
`firstName`	string	User first name
`lastName`	string	User last name
`uuid`	string	Internal UUID
`createdAt`	string	Creation timestamp
`updatedAt`	string	Last update timestamp
`metadata`	object	User metadata

`zep_get_user_threads`

List all conversation threads for a specific user

Input

Parameter	Type	Required	Description
`userId`	string	Yes	User ID to get threads for
`limit`	number	No	Maximum number of threads to return
`apiKey`	string	Yes	Your Zep API key

Output

Parameter	Type	Description
`threads`	array	Array of thread objects for this user
`userId`	string	The user ID

Notes

Category: tools
Type: zep

Zep

On this page