mnemo
About
Persistent memory for AI coding agents. mnemo stores decisions, bugs, conventions, and discoveries across sessions in a local SQLite database.
Explore
- Session hooks: Automatically starts/ends sessions and injects memory context at the beginning of every conversation
- 14 MCP tools: mem_save, mem_search, mem_context, mem_session_summary, and more, available directly inside your editor
- Passive capture: Extracts learnings from conversation transcripts automatically at session end
- Full CLI: Save, search, export, import, and inspect memories from the terminal
- Own storage: Isolated ~/.mnemo/memory.db, created automatically on first run
- Claude Code + Cursor: Native integration for both editors via their respective hook systems
---
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
mnemoCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Go 1.22+
- macOS or Linux
- Claude Code CLI — for mnemo setup (Claude Code integration)
- Cursor 2.6+ — for mnemo setup --cursor (Cursor integration)
---
``bash`
curl -sSf https://raw.githubusercontent.com/jmeiracorbal/mnemo/main/install.sh | bash
This downloads the binary for your platform, installs it to , and runs mnemo setup` automatically.
Options:
MNEMO_VERSION=v0.1.0 curl -sSf .../install.sh | bash
MNEMO_INSTALL_DIR=/usr/local/bin curl -sSf .../install.sh | bash
---
mem_save
Save a memory with title, content, type, and optional topic key
mem_search
Full-text search across all memories
mem_context
Retrieve formatted context from previous sessions
mem_session_summary
Save an end-of-session summary with goal, discoveries, next steps
mem_session_start
Register a new session
mem_session_end
Mark a session as completed
mem_get_observation
Retrieve full content of a memory by ID
mem_suggest_topic_key
Suggest a topic key for deduplication
mem_capture_passive
Extract and save learnings from free-form text
mem_save_prompt
Save a prompt template
mem_update
Update an existing memory
Tools available inside your editor via the mcp__mnemo__* namespace:
| Tool | Description |
|---|---|
| mem_save | Save a memory with title, content, type, and optional topic key |
| mem_search | Full-text search across all memories |
| mem_context | Retrieve formatted context from previous sessions |
| mem_session_summary | Save an end-of-session summary with goal, discoveries, next steps |
| mem_session_start | Register a new session |
| mem_session_end | Mark a session as completed |
| mem_get_observation | Retrieve full content of a memory by ID |
| mem_suggest_topic_key | Suggest a topic key for deduplication |
| mem_capture_passive | Extract and save learnings from free-form text |
| mem_save_prompt | Save a prompt template |
| mem_update | Update an existing memory |
Available with --tools=admin: mem_delete, mem_stats, mem_timeline.
``bash``
claude mcp add -s user mnemo-admin -- ~/.local/bin/mnemo mcp --tools=admin
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mnemo": {
"mnemo": {
"command": "mnemo",
"args": [
"mcp",
"--tools=agent"
]
}
}
}
}McpServers
{
"mnemo": {
"command": "mnemo",
"args": [
"mcp",
"--tools=agent"
]
}
}
Persistent memory for AI coding agents. mnemo stores decisions, bugs, conventions, and discoveries across sessions in a local SQLite database. A one-command setup wires it into Claude Code or Cursor via hooks and MCP.
---
Features
- Session hooks: Automatically starts/ends sessions and injects memory context at the beginning of every conversation - 14 MCP tools:mem_save, mem_search, mem_context, mem_session_summary, and more, available directly inside your editor
- Passive capture: Extracts learnings from conversation transcripts automatically at session end
- Full CLI: Save, search, export, import, and inspect memories from the terminal
- Own storage: Isolated ~/.mnemo/memory.db, created automatically on first run
- Claude Code + Cursor: Native integration for both editors via their respective hook systems
---
Requirements
- Go 1.22+ - macOS or Linux - Claude Code CLI — formnemo setup (Claude Code integration)
- Cursor 2.6+ — for mnemo setup --cursor (Cursor integration)
---
Installation
Option A: One-line installer (recommended)
``bash
curl -sSf https://raw.githubusercontent.com/jmeiracorbal/mnemo/main/install.sh | bash
`
This downloads the binary for your platform, installs it to ~/.local/bin/, and runs mnemo setup automatically.
Options:
``bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
