OpenCode

Add persistent memory to OpenCode with the Mem0 plugin. Your agent forgets everything between sessions. Mem0 fixes that by storing decisions, preferences, and learnings so they carry over automatically.

Current package version: 0.3.0.

Prerequisites

A Mem0 API key (starts with m0-):
- Get your API key (free sign-up at app.mem0.ai)
Add it to your shell profile so it persists across sessions:

echo 'export MEM0_API_KEY="m0-your-api-key"' >> ~/.zshrc && source ~/.zshrc

echo 'export MEM0_API_KEY="m0-your-api-key"' >> ~/.bashrc && source ~/.bashrc

Installation

Option A: Plugin Install (Recommended)

opencode plugin @mem0/opencode-plugin

Or let your agent do it: paste this into OpenCode:

Install @mem0/opencode-plugin by following https://raw.githubusercontent.com/mem0ai/mem0/main/integrations/opencode-plugin/README.md

This adds the plugin to your ~/.config/opencode/opencode.json. Restart OpenCode. You get the native memory tools, lifecycle hooks, and all /mem0-* slash commands. The memory tools are registered by the plugin itself via the mem0ai SDK. No MCP server to configure.

Option B: Standalone MCP Server

If you only need the memory tools without the plugin’s hooks or skills, point OpenCode at Mem0’s hosted MCP server directly. Add this to your opencode.json (project-level or global at ~/.config/opencode/opencode.json):

{
  "mcp": {
    "mem0": {
      "type": "remote",
      "url": "https://mcp.mem0.ai/mcp/",
      "headers": {
        "Authorization": "Token {env:MEM0_API_KEY}"
      },
      "oauth": false
    }
  }
}

What’s Included

Component	Plugin (A)	Standalone MCP (B)
10 memory tools	Native (SDK)	9 remote MCP tools
Lifecycle Hooks	Yes	No
7 Skills	Yes	No

Available Memory Tools

Tool	Description
`add_memory`	Save text or conversation history for a user/agent
`search_memories`	Semantic search across memories with filters
`get_memories`	List memories with filters and pagination
`get_memory`	Retrieve a specific memory by ID
`update_memory`	Overwrite a memory’s text by ID
`delete_memory`	Delete a single memory by ID
`delete_all_memories`	Bulk delete all memories in scope
`delete_entities`	Delete a user/agent/app/run entity and its memories
`list_entities`	List users/agents/apps/runs stored in Mem0
`get_event_status`	Check the processing status of an asynchronous memory event

Memory scope

search_memories, get_memories, add_memory, and delete_all_memories accept an optional scope that controls how widely they read or write:

Scope	Reads	Writes
`project` (default)	this repo (`user_id` + `app_id`)	this repo
`session`	this run only (`+ run_id`)	this run
`global`	all your projects in the workspace (filtered by your user ID)	user-wide

Select /mem0-scope global before requesting a cross-project tool operation. A tool cannot enable global scope by supplying an argument alone. Switch back with /mem0-scope project when finished. To change the default scope (used when no scope is passed), run the /mem0-scope skill:

/mem0-scope            # show the current default scope + identity
/mem0-scope global     # save & search across all your projects by default
/mem0-scope project    # back to repo-only (the default)

The default persists in ~/.mem0/settings.json (default_scope) and is read fresh on each memory operation, so a change applies immediately. No restart. delete_all_memories always requires an explicit scope: "global" to delete user-wide, so changing the default can’t trigger a cross-project wipe. The project id (app_id) is derived from your git remote (owner-repo), falling back to the git repo’s root directory name, then the current directory. Launch OpenCode from inside your repo so memories scope to the project rather than your home directory.

Lifecycle Hooks

The plugin uses the mem0ai TypeScript SDK directly. It is pure TypeScript, no Python, no shell scripts.

OpenCode Event	Hook	What happens
`config`	Config	Registers the `/mem0-*` slash commands (`config.command`) and adds the plugin’s own `opencode-skills/` dir to OpenCode’s `skills.paths` for in-place skill discovery (no copying)
`chat.message`	Chat message	Searches prior memories on session start, searches relevant memories before each prompt, auto-captures learnings periodically
`tool.execute.before`	Pre-tool	Blocks MEMORY.md writes, steering them to the `add_memory` tool
`tool.execute.after`	Post-tool	Scans Bash errors and pre-fetches related error memories
`experimental.chat.messages.transform`	Messages transform	Injects memory context (session memories, search results, error lookups) into the prompt
`experimental.session.compacting`	Compaction	Stores session state memory, then injects prior memories into compaction context so nothing is lost
`shell.env`	Shell env	Exports `MEM0_USER_ID`, `MEM0_APP_ID`, `MEM0_SESSION_ID`, and `MEM0_BRANCH` to all shell executions

Troubleshooting

No tools appearing: Restart OpenCode after installing
“Connection failed”: Verify your key is set: echo $MEM0_API_KEY
Plugin not loading: Run opencode plugin @mem0/opencode-plugin again, then restart
Hooks not firing: Hooks require the plugin install (Option A). MCP-only installs don’t include hooks.
Wrong project name / memories not found: The project id comes from your git remote; launch OpenCode from inside the repo (not your home directory). Check the resolved id with /mem0-status.

Mem0 MCP Setup

Detailed MCP configuration for all clients

Antigravity Integration

Add Mem0 memory to Google Antigravity

Using Mem0? Star us on GitHub to help more developers discover memory for AI apps.

Coding Agents

Agent Harness

Prerequisites

Installation

Option A: Plugin Install (Recommended)

Option B: Standalone MCP Server

What’s Included

Available Memory Tools

Memory scope

Lifecycle Hooks

Troubleshooting

Mem0 MCP Setup

Antigravity Integration

​Prerequisites

​Installation

​Option A: Plugin Install (Recommended)

​Option B: Standalone MCP Server

​What’s Included

​Available Memory Tools

​Memory scope

​Lifecycle Hooks

​Troubleshooting

Mem0 MCP Setup

Antigravity Integration

Prerequisites

Installation

Option A: Plugin Install (Recommended)

Option B: Standalone MCP Server

What’s Included

Available Memory Tools

Memory scope

Lifecycle Hooks

Troubleshooting