Implement Zep with agents

Install the Build with Zep plugin so Claude Code and Codex build on Zep with the current docs and best practices.

Coding agents build on Zep faster when they understand how Zep works and can read the current documentation as they write code. The Build with Zep plugin gives Claude Code and Codex both: a skill that encodes how to design, build, and evaluate a Zep integration, and the Zep documentation MCP server for real-time search over the docs. One plugin installs in either ecosystem.

The plugin is for building with Zep in your own codebase. You’ll still need a Zep project and API key — start with the quick start guide.

What the plugin includes

The plugin bundles two things that work together:

  • The building-with-zep skill — the decision-and-workflow layer for building on Zep: scoping graphs, ingesting data, retrieving context, and evaluating whether Zep delivers your use case. Your agent invokes it automatically when you write or design Zep integration code. It indexes the docs rather than duplicating them, so its guidance stays current.
  • The Zep documentation MCP server (zep-docs) — real-time search and whole-page access over Zep’s documentation, served at https://docs-mcp.getzep.com/mcp (remote HTTP, no API key). The skill queries it for exact, current details — method names, parameters, limits — and prefers reading a full page over a search snippet.

The plugin is open source — the skill and its MCP configuration live in plugins/building-with-zep in the getzep/zep repository.

Install

From your terminal (not inside a Claude Code session), add the getzep/zep marketplace and install the plugin:

$claude plugin marketplace add getzep/zep
$claude plugin install building-with-zep@zep

How your agent uses it

Once installed, the skill activates on its own when you work on Zep: adding memory to an agent, ingesting chat or business data, searching the graph, choosing between user and standalone graphs, or debugging retrieval. As it works, the agent reads the current documentation through the zep-docs MCP server instead of relying on its training data, so its code and recommendations track the live docs — and when the two disagree, the docs win.

Just the documentation MCP server

If you want real-time documentation search in another MCP client — Cursor, or any tool that isn’t Claude Code or Codex — set up the Zep documentation MCP server on its own, without the skill.