search_conversationsLABSCO SUMMARY
Unusually candid about its own numbers.
The performance section is the tell. The author found the benchmark script was measuring coroutine construction rather than search time, replaced every previously published figure with a measured one, and left a note saying the old numbers were never actually measured. The current claim is modest and reproducible: FTS5 search around 10 to 13ms median on a 159-conversation dataset, roughly ten times faster than the linear JSON scan it replaces. Treat those as order-of-magnitude, as the README asks.
What it is
An MCP server that stores conversations and makes them searchable with SQLite FTS5 full-text search and relevance ranking. Conversations are filed on disk by date and topic under ~/claude-memory/, with topics extracted automatically, and importers cover Claude, ChatGPT, Cursor and a generic format.
What you get
- Full-text search with relevance ranking, where query text is treated as literal Unicode terms so punctuation and FTS5 operators do not change what you asked —
search_conversations, returning IDs for exact retrieval - Retrieval of a stored conversation by ID, read from the authoritative JSON store and truncated to a
max_charslimit so a long thread cannot flood the model's context —get_conversation - Storage with automatic topic extraction and indexing —
add_conversation - Four narrower lookups:
search_by_topic,search_by_tagfor metadata likestarredorarchived,search_by_session_idfor reconstructing a multi-turn session spread across several records (returned oldest first), andsearch_by_conversation_typeforchat,codeoranalysis - In-place edits with an audit trail —
update_conversationrewrites only the fields you pass and, by default, prepends a self-documenting audit line chained across repeated updates; tag operations distinguish replacing the whole list from adding and removing individual tags generate_weekly_summaryfor insights and patterns over recent conversations, andget_search_statsfor index size, topic counts and engine status
Requirements
No account and no key — everything is local. Python 3.10 or newer. Install it as an application with uv tool install universal-memory-mcp or pipx install universal-memory-mcp, not a bare pip install, which fails on PEP 668 systems with error: externally-managed-environment; inside an activated virtualenv pip install is fine. Then claude mcp add --transport stdio universal-memory-mcp -- universal-memory-mcp, or name the console script directly in your config. Conversations live in ~/claude-memory/ whatever you call the server. CLAUDE_MEMORY_PATH moves the store, CLAUDE_MEMORY_DISABLE_SQLITE falls back to JSON linear search on platforms without FTS5, and CLAUDE_MCP_LOG_FORMAT, CLAUDE_MCP_LOG_LEVEL, CLAUDE_MCP_CONSOLE_OUTPUT and CLAUDE_MCP_PLATFORM_PROFILE tune logging and defaults. Settings can also live in a config file, where an unknown key raises an error rather than being ignored. MIT licensed.
Setup effort
One command — uv tool install universal-memory-mcp
USE CASES
Finding the conversation where you solved this before
Search across everything stored and retrieve the matching conversation by the ID the search returned.
Rebuilding a session that spans several records
Pull every conversation sharing a session ID, returned in chronological order, instead of piecing the thread together by hand.
Bringing history in from another assistant
Import a JSON export from Claude, ChatGPT or Cursor and let topic extraction and indexing run over it.
Keeping a working set marked
Tag conversations with values like starred or a workspace name and search by that tag later.
Seeing what you actually worked on this week
Generate a weekly summary of insights and patterns from recent conversations.
10 tools
Listed in project docs. Your client may show a different list.
get_conversationsearch_by_topicadd_conversationgenerate_weekly_summaryget_search_statsupdate_conversationsearch_by_tagsearch_by_session_idsearch_by_conversation_typeBEFORE YOU INSTALL
What to know first
Tools you get
10 tools named in the project's documentation.
Requires
- universal-memory-mcp on PATH
- Python 3.10+
Where it runs
All 3 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
uv tool install universal-memory-mcpMCP Clients
Claude Code, Claude Desktop
{
"mcpServers": {
"universal-memory-mcp": {
"command": "universal-memory-mcp"
}
}
}Codex
[mcp_servers.universal-memory-mcp]
command = "universal-memory-mcp"