Zep MCP Server

Simple MCP server that wraps Zep Cloud API (v3) for use with Claude Code.

Enables Claude Code to store and retrieve memories using Zep's thread-based memory system.

Installation

Configuration

Add to your ~/.claude.json:

Get your Zep API key from https://www.getzep.com

Usage

Three tools available in Claude Code:

zep_store_memory

Store information in a Zep session.

zep_search_memory

Search for information in a Zep session.

zep_get_memory

Get recent memories from a session with pagination and filtering support.

Parameters:

• session_id (required): Thread/Session ID to retrieve

• lastn (optional): Number of most recent messages to return (e.g., 50, 100, 200)

• limit (optional): Limit the number of results returned (alternative to lastn)

• cursor (optional): Cursor for pagination (used with limit)

• role_filter (optional): Filter by message role: "user", "assistant", or "system"

Examples:

Thread/Session Naming Convention

• Global knowledge: global

• Project-specific: project-{name}

• User-specific: user-{username}

Note: This server uses Zep Cloud v3 API which uses "threads" instead of "sessions". The tools still accept session_id for backwards compatibility.

Example

License

MIT