MCP
The MCP server exposes read-only project memory tools to MCP-capable clients, including coding agents. Use MCP when a client supports structured tools. Use the CLI when a shell command is simpler or when you want direct human-readable output.
stdio server
Run a local stdio MCP server for clients that spawn tools as child processes (Codex, Claude Code, etc.):
memory mcp run --project <slug>
memory mcp status --project <slug>Stdio mode writes only MCP JSON-RPC messages to stdout; diagnostics go to stderr.
Streamable HTTP server
The service can expose MCP over a local HTTP route, typically /mcp. Use this only for local, token-bearing clients unless you add your own network and authentication controls.
Tools
The MCP surface is read-first and focused on project context.
| Tool | Purpose |
|---|---|
memory_query | Ask a project question and return answers with citations. |
memory_search_all | Search all projects and return project/repository routing metadata for each result. |
memory_resume | Generate a continuation briefing. |
memory_up_to_speed | Generate a new-agent briefing. |
memory_overview | Inspect counts and project state. |
memory_list_memories | Browse memory rows. |
memory_get_memory | Inspect one memory. |
memory_memory_history | Read memory version history. |
memory_list_activities | Inspect activity events. |
memory_list_replacement_proposals | Review pending proposals without approving them. |
Use memory_search_all when an agent can work across several repositories. The result JSON includes project, project_name, and repo_root fields when the service can identify them. After choosing a result, switch to that repository and continue with project-scoped tools or normal code actions.
When a task may belong to any repository, call memory_search_all first. Use the
project and repo_root metadata from the strongest cited result to choose where
follow-up actions should happen.Security
- Prefer stdio for local desktop or CLI clients.
- Keep Streamable HTTP bound to local interfaces unless you add network controls.
- Require token-bearing clients for HTTP MCP.
- Scope tools to explicit projects.
- Do not expose MCP HTTP to the public internet.
Next
Read Agents, Watchers, or Operations.