Skip to content

armgit / mem0

Public Imported from GitHub
0

The Memory Layer for AI Agents - Drop-in memory infrastructure for AI agents and apps. Context that persists. Built for production.

fix(plugin): make Cursor plugin fully functional (#4547)

Gabriel Stein4e414e401530
diff --git a/mem0-plugin/.claude-plugin/plugin.json b/mem0-plugin/.claude-plugin/plugin.json
index d64acdb67..68777ad54 100644
--- a/mem0-plugin/.claude-plugin/plugin.json
+++ b/mem0-plugin/.claude-plugin/plugin.json
@@ -4,8 +4,9 @@
"description": "Mem0 memory layer for AI applications. Add persistent memory, personalization, and semantic search to Claude workflows using the Mem0 Platform MCP server.",
"author": {
"name": "Mem0",
- "url": "https://github.com/mem0ai"
+ "email": "[email protected]"
},
+ "homepage": "https://mem0.ai",
"repository": "https://github.com/mem0ai/mem0",
"logo": "logo.svg",
"license": "Apache-2.0"
diff --git a/mem0-plugin/.cursor-mcp.json b/mem0-plugin/.cursor-mcp.json
new file mode 100644
index 000000000..80c40be60
--- /dev/null
+++ b/mem0-plugin/.cursor-mcp.json
@@ -0,0 +1,10 @@
+{
+ "mcpServers": {
+ "mem0": {
+ "url": "https://mcp.mem0.ai/mcp/",
+ "headers": {
+ "Authorization": "Token ${env:MEM0_API_KEY}"
+ }
+ }
+ }
+}
diff --git a/mem0-plugin/.cursor-plugin/plugin.json b/mem0-plugin/.cursor-plugin/plugin.json
index b901e3d43..8ba1249cc 100644
--- a/mem0-plugin/.cursor-plugin/plugin.json
+++ b/mem0-plugin/.cursor-plugin/plugin.json
@@ -4,9 +4,14 @@
"description": "Mem0 memory layer for AI applications. Add persistent memory, personalization, and semantic search using the Mem0 Platform MCP server.",
"author": {
"name": "Mem0",
- "url": "https://github.com/mem0ai"
+ "email": "[email protected]"
},
+ "homepage": "https://mem0.ai",
"repository": "https://github.com/mem0ai/mem0",
"logo": "logo.svg",
- "license": "Apache-2.0"
+ "license": "Apache-2.0",
+ "keywords": ["mem0", "memory", "mcp", "personalization", "semantic-search"],
+ "skills": "./skills/",
+ "hooks": "./hooks/cursor-hooks.json",
+ "mcpServers": ".cursor-mcp.json"
}
diff --git a/mem0-plugin/README.md b/mem0-plugin/README.md
index c1f1e77f9..2ffe2e07a 100644
--- a/mem0-plugin/README.md
+++ b/mem0-plugin/README.md
@@ -1,10 +1,10 @@
-# Mem0 Plugin for Claude & Cursor
+# Mem0 Plugin for Claude Code, Claude Cowork & Cursor
-Add persistent memory to your AI coding workflows. Store, retrieve, and manage memories across sessions using the Mem0 Platform. Works with both **Claude Code** and **Cursor**.
+Add persistent memory to your AI workflows. Store, retrieve, and manage memories across sessions using the Mem0 Platform. Works with **Claude Code** (CLI), **Claude Cowork** (desktop app), and **Cursor**.
## Step 1: Set your API key
-> **You must complete this step before installing the plugin for either Claude Code or Cursor.**
+> **You must complete this step before installing the plugin.**
1. Sign up at [app.mem0.ai](https://app.mem0.ai) if you haven't already
2. Go to [app.mem0.ai/dashboard/api-keys](https://app.mem0.ai/dashboard/api-keys)
@@ -30,22 +30,51 @@ Add persistent memory to your AI coding workflows. Store, retrieve, and manage m
## Step 2: Install the plugin
-Choose one of the options below. Both require `MEM0_API_KEY` to be set first (see above).
+Choose one of the options below. All require `MEM0_API_KEY` to be set first (see above).
-### Claude Code
+### Claude Code (CLI) / Claude Cowork (Desktop)
+
+Claude Code and Claude Cowork share the same plugin system.
+
+**CLI:**
```
/plugin marketplace add mem0ai/mem0
/plugin install mem0@mem0-plugins
```
+**Cowork desktop app:** Open the Cowork tab, click **Customize** in the sidebar, click **Browse plugins**, and install Mem0.
+
+This installs the full plugin including the MCP server, lifecycle hooks (automatic memory capture), and the Mem0 SDK skill.
+
### Cursor
-Click the deeplink below to install the Mem0 MCP server in Cursor:
+> **Already have `mem0` configured as an MCP server?** Remove the existing entry from your Cursor MCP settings before installing to avoid duplicate tools.
+
+**Option A — One-click deeplink** (installs MCP server only):
+
+[Install Mem0 MCP in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=mem0&config=eyJtY3BTZXJ2ZXJzIjp7Im1lbTAiOnsidXJsIjoiaHR0cHM6Ly9tY3AubWVtMC5haS9tY3AvIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiVG9rZW4gJHtlbnY6TUVNMF9BUElfS0VZfSJ9fX19)
-[Install Mem0 MCP in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=mem0&config=eyJtY3BTZXJ2ZXJzIjp7Im1lbTAiOnsidHlwZSI6Imh0dHAiLCJ1cmwiOiJodHRwczovL21jcC5tZW0wLmFpL21jcC8iLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJUb2tlbiAke01FTTBfQVBJX0tFWX0ifX19fQ==)
+**Option B — Manual configuration** (MCP server only):
-> **Already have `mem0` configured as an MCP server?** Remove the existing entry from your `.mcp.json` or settings before installing this plugin to avoid duplicate tools.
+Add the following to your `.cursor/mcp.json`:
+
+```json
+{
+ "mcpServers": {
+ "mem0": {
+ "url": "https://mcp.mem0.ai/mcp/",
+ "headers": {
+ "Authorization": "Token ${env:MEM0_API_KEY}"
+ }
+ }
+ }
+}
+```
+
+**Option C — Cursor Marketplace** (full plugin with hooks and skills):
+
+Install from the [Cursor Marketplace](https://cursor.com/marketplace) for the complete experience including lifecycle hooks and the Mem0 SDK skill.
## Verify it works
@@ -57,8 +86,15 @@ After installing, confirm the MCP server is connected:
## What's included
+| Component | Claude Code / Cowork | Cursor (Marketplace) | Cursor (Deeplink/Manual) |
+|-----------|:--------------------:|:--------------------:|:------------------------:|
+| MCP Server | Yes | Yes | Yes |
+| Lifecycle Hooks | Yes | Yes | No |
+| Mem0 SDK Skill | Yes | Yes | No |
+
- **MCP Server** — Connects to the Mem0 remote MCP server (`mcp.mem0.ai`), providing tools to add, search, update, and delete memories. No local dependencies required.
-- **Mem0 Skill** — Guides Claude on how to integrate the Mem0 SDK (Python & TypeScript) into your applications
+- **Lifecycle Hooks** — Automatic memory capture at key points: session start, context compaction, task completion, and session end.
+- **Mem0 SDK Skill** — Guides the AI on how to integrate the Mem0 SDK (Python & TypeScript) into your applications.
## MCP Tools
diff --git a/mem0-plugin/hooks/cursor-hooks.json b/mem0-plugin/hooks/cursor-hooks.json
new file mode 100644
index 000000000..442d3718e
--- /dev/null
+++ b/mem0-plugin/hooks/cursor-hooks.json
@@ -0,0 +1,37 @@
+{
+ "hooks": {
+ "sessionStart": [
+ {
+ "command": "${CURSOR_PLUGIN_ROOT}/scripts/on_session_start.sh",
+ "matcher": "startup|resume|compact"
+ }
+ ],
+ "preToolUse": [
+ {
+ "command": "${CURSOR_PLUGIN_ROOT}/scripts/block_memory_write.sh",
+ "matcher": "Write|Edit"
+ }
+ ],
+ "preCompact": [
+ {
+ "command": "${CURSOR_PLUGIN_ROOT}/scripts/on_pre_compact.sh"
+ },
+ {
+ "command": "python3 ${CURSOR_PLUGIN_ROOT}/scripts/on_pre_compact.py",
+ "timeout": 30
+ }
+ ],
+ "stop": [
+ {
+ "command": "${CURSOR_PLUGIN_ROOT}/scripts/on_stop.sh",
+ "timeout": 10
+ }
+ ],
+ "beforeSubmitPrompt": [
+ {
+ "command": "${CURSOR_PLUGIN_ROOT}/scripts/on_user_prompt.sh",
+ "timeout": 5
+ }
+ ]
+ }
+}