lean-memory MCP
An embedded, local-first agent memory system that stores facts in per-namespace SQLite files. It supports hybrid dense+sparse search, automatic fact supersession, and point-in-time queries. The package includes an MCP server bridge for integration with Claude Desktop and Claude Code, running fully offline without mandatory cloud keys.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
Checks and signals
Each line is separate evidence, not a trust score.
- Popularity 43 GitHub stars
What you can do with it
- Store and retrieve user facts in natural language
- Perform hybrid dense and sparse search queries
- Query memory at a specific point in time
- Integrate agent memory with Claude Code
Source and maintenance
- Last repository push
- Latest release
- v0.3.0
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
lean-memory 0.3.0
{
"version": "0.3.0",
"transport": "stdio",
"identifier": "lean-memory",
"runtimeHint": "uvx",
"registryType": "pypi",
"registryBaseUrl": "https://pypi.org",
"packageArguments": [
{
"type": "positional",
"value": "lean-memory-mcp",
"isRequired": true,
"description": "Console script entry point that starts the stdio MCP server."
}
],
"runtimeArguments": [
{
"name": "--from",
"type": "named",
"value": "lean-memory[mcp,models,extract]",
"isRequired": true,
"description": "Install lean-memory with the extras the server needs: [mcp] (imported at startup — a bare install crashes), plus [models] and [extract] (the canonical real-quality backends; ~2 GB of open models download on first tool call). The package name and script name differ, so uvx needs --from."
}
],
"environmentVariables": [
{
"name": "LM_DATA_ROOT",
"default": "~/.lean_memory",
"description": "Directory for per-namespace SQLite memory files. Defaults to ~/.lean_memory when unset."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"lean-memory-mcp": {
"command": "uvx",
"args": [
"lean-memory==0.3.0",
"lean-memory-mcp"
],
"env": {
"LM_DATA_ROOT": "<YOUR_LM_DATA_ROOT>"
}
}
}
}Cline
{
"mcpServers": {
"lean-memory-mcp": {
"command": "uvx",
"args": [
"lean-memory==0.3.0",
"lean-memory-mcp"
],
"env": {
"LM_DATA_ROOT": "<YOUR_LM_DATA_ROOT>"
}
}
}
}VS Code
{
"servers": {
"lean-memory-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"lean-memory==0.3.0",
"lean-memory-mcp"
],
"env": {
"LM_DATA_ROOT": "<YOUR_LM_DATA_ROOT>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"lean-memory-mcp": {
"command": "uvx",
"args": [
"lean-memory==0.3.0",
"lean-memory-mcp"
],
"env": {
"LM_DATA_ROOT": "<YOUR_LM_DATA_ROOT>"
}
}
}
}Let your agent find its tools
Find servers like lean-memory MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.