Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,11 @@
{
"name": "zep-memory",
"source": "zep-memory",
"description": "Long-term memory for knowledge work via the Zep Memory MCP server.",
"description": "Use Zep as long-term memory for knowledge work. Bundles a skill plus the Zep Memory MCP server.",
"logo": "assets/logo.png",
"homepage": "https://help.getzep.com/memory-mcp-server",
"repository": "https://github.com/getzep/zep-memory-plugin",
"license": "Apache-2.0",
"category": "productivity",
"keywords": [
"zep",
Expand Down
19 changes: 15 additions & 4 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,14 @@ ChatGPT Work.
`plugins/zep-memory/.cursor-plugin/` unless we need Cursor-only components
(rules, agents, commands, hooks, or variables). Auth stays client-managed
OAuth; do not put API keys or `${VAR}` headers in `mcp.json`.
- Keep `plugins/zep-memory/assets/logo.png` and reference it from
`.cursor-plugin/marketplace.json` (`logo`: `assets/logo.png`). Agent Plugins
`plugin.json` has no logo field.
- Keep Terms of Service and Privacy Policy links highly visible in
`README.md` and `plugins/zep-memory/README.md`, pointing at
https://www.getzep.com/legal/terms/ and
https://www.getzep.com/legal/privacy/. Do not invent a plugin-only legal
page; this plugin uses the Zep Memory API.
- This repository hosts its own marketplace catalogs
(`.claude-plugin/marketplace.json`, `.agents/plugins/marketplace.json`,
and `.cursor-plugin/marketplace.json`). Plugin `source` entries must stay
Expand Down Expand Up @@ -145,7 +153,10 @@ open Zep sign-in.
- **Team marketplace:** import this GitHub repository. Cursor reads
`.cursor-plugin/marketplace.json` and resolves `source` `zep-memory` under
`pluginRoot` `plugins`.
- **Official Cursor Marketplace (later):** submit the repository at
[cursor.com/marketplace/publish](https://cursor.com/marketplace/publish).
Inclusion and updates are a Cursor review process, not "merge this repo and
it ships."
- **Official Cursor Marketplace:** submit this GitHub repository at
[cursor.com/marketplace/publish](https://cursor.com/marketplace/publish)
while signed into the Cursor account that should own the listing. Cursor
reviews identity, code, and every later update; request a re-index after
changes. Merging to GitHub does not publish or update the public listing.
The plugin must stay free, Apache-2.0, and public. Keep ToS/privacy links
visible in the READMEs.
3 changes: 3 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,9 @@ All notable changes to the Zep Memory plugin.
- Document Cursor as an Agent Plugins host (no extra per-plugin Cursor
manifest). Add `.cursor-plugin/marketplace.json` so this repo can be
imported as a Cursor team marketplace pointing at `plugins/zep-memory`.
- Prepare the public Cursor Marketplace listing: commit `assets/logo.png`,
document usage and OAuth configuration, and put Zep’s Terms of Service and
Privacy Policy links at the top of the repo and plugin READMEs.

## 0.2.10 — 2026-08-14

Expand Down
62 changes: 58 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,14 +10,61 @@ Bundles:
standalone graphs via LLM-mediated Memory MCP tool calls
- The Zep Memory MCP server at `https://api.getzep.com/mcp`

## Terms and privacy

**Read these before installing or using this plugin.** They are the terms of
service and privacy policy for this plugin.

- **[Terms of Service](https://www.getzep.com/legal/terms/)**
- **[Privacy Policy](https://www.getzep.com/legal/privacy/)**

The plugin files (skill, manifests, and MCP config) are also licensed under the
[Apache License 2.0](LICENSE).

This plugin connects the host to Zep’s Memory MCP server. You sign in with
OAuth. After that, the assistant can search and add to your Zep memory — your
user graph, and standalone graphs when your project enables them. That API and
memory data is handled under the Privacy Policy above.

## Usage

Once installed and signed in, ask the assistant to recall or save durable
context. For example:

- What do you remember about me?
- Search my Zep memory for relevant context on this topic.
- Save this to my Zep memory.

The skill tells the assistant to prefer Zep over the host’s built-in memory,
to look up stored context before guessing, and to write durable facts
(preferences, corrections, procedures, decisions, feedback) without waiting to
be asked.

Install and product docs: [Memory MCP server](https://help.getzep.com/memory-mcp-server).

## Configuration

No API keys, plugin variables, or other secrets belong in this repository. Auth
is client-managed OAuth against `https://api.getzep.com/mcp`.

The first Memory MCP call should prompt for Zep sign-in (work email → identity
provider → project). You need a Zep account whose project has Memory MCP
enabled.

## Support

- Docs: [Memory MCP server](https://help.getzep.com/memory-mcp-server)
- Issues: [getzep/zep-memory-plugin](https://github.com/getzep/zep-memory-plugin/issues)

## Product intent

- Teach knowledge-work assistants to use Zep as durable memory
- LLM-written memories via MCP tools are the v1 write path (hooks /
auto-ingest of every message are out of scope)
- Internal rollout first via Claude Team / Enterprise, ChatGPT workspace
distribution, and Cursor local / team-marketplace install; public
marketplace later
- Internal rollout via Claude Team / Enterprise, ChatGPT workspace
distribution, and Cursor local / team-marketplace install; public Cursor
Marketplace listing is a separate Cursor review after submitting this
repository
- Docs follow-up: install instructions on the Memory MCP docs page

## Packaging note
Expand Down Expand Up @@ -63,9 +110,16 @@ should prompt for Zep OAuth (work email → IdP → project).
You can also import this GitHub repository as a Cursor team marketplace;
`.cursor-plugin/marketplace.json` points at the same plugin root.

To list on the public [Cursor Marketplace](https://cursor.com/marketplace),
submit this repository at
[cursor.com/marketplace/publish](https://cursor.com/marketplace/publish).
Cursor reviews the listing and every later update; merging to GitHub does not
publish by itself.

## Releasing

Keep portable, Claude, and ChatGPT Work manifest versions synchronized with
`python3 scripts/plugin_manifests.py set <version>`, validate, then open a PR.
How that reaches users (Claude org marketplace, ChatGPT Work workspace share,
public directories later) is documented under **Releasing** in [`AGENTS.md`](AGENTS.md).
Cursor team marketplace, public Cursor Marketplace) is documented under
**Releasing** in [`AGENTS.md`](AGENTS.md).
56 changes: 56 additions & 0 deletions plugins/zep-memory/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# Zep Memory

Use Zep as long-term memory for knowledge work in **Cursor**, **Claude Desktop
Chat**, **Claude Cowork**, and **ChatGPT Work**.

Bundles:

- The `zep-memory` skill — how to use Zep for user memory, threads, and
standalone graphs via LLM-mediated Memory MCP tool calls
- The Zep Memory MCP server at `https://api.getzep.com/mcp`

## Terms and privacy

**Read these before installing or using this plugin.** They are the terms of
service and privacy policy for this plugin.

- **[Terms of Service](https://www.getzep.com/legal/terms/)**
- **[Privacy Policy](https://www.getzep.com/legal/privacy/)**

The plugin files (skill, manifests, and MCP config) are also licensed under the
[Apache License 2.0](../../LICENSE).

This plugin connects Cursor (and other supported hosts) to Zep’s Memory MCP
server. You sign in with OAuth. After that, the assistant can search and add to
your Zep memory — your user graph, and standalone graphs when your project
enables them. That API and memory data is handled under the Privacy Policy
above.

## Usage

Once installed and signed in, ask the assistant to recall or save durable
context. For example:

- What do you remember about me?
- Search my Zep memory for relevant context on this topic.
- Save this to my Zep memory.

The skill tells the assistant to prefer Zep over the host’s built-in memory,
to look up stored context before guessing, and to write durable facts (preferences,
corrections, procedures, decisions, feedback) without waiting to be asked.

Install and product docs: [Memory MCP server](https://help.getzep.com/memory-mcp-server).

## Configuration

No API keys, plugin variables, or other secrets belong in this package. Auth is
client-managed OAuth against `https://api.getzep.com/mcp`.

The first Memory MCP call should prompt for Zep sign-in (work email → identity
provider → project). You need a Zep account whose project has Memory MCP
enabled.

## Support

- Docs: [Memory MCP server](https://help.getzep.com/memory-mcp-server)
- Issues: [getzep/zep-memory-plugin](https://github.com/getzep/zep-memory-plugin/issues)
Binary file added plugins/zep-memory/assets/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading