sessionmem
Local-first MCP server that stores project memories across AI coding sessions in SQLite.
Tested on macOS and Linux
Use it
macOS arm64
You need first
- Runtimes:
Node.js 20.19+ or 22.13+
install sessionmem via npm install -g sessionmem
npm install -g sessionmem
Check that it works
sessionmem pingThe output should contain “sessionmem is operational”.
First thing to try
sessionmem pingAdd it to your agent
claude mcp add sessionmem -- sessionmem runJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"sessionmem": {
"command": "sessionmem",
"args": [
"run"
]
}
}
}Add sessionmem run as an MCP server command in your AI coding client, then call its tools from there.
Linux x86_64
You need first
- Runtimes:
Node.js 20.19+ or 22.13+
install sessionmem via npm
npm install -g sessionmem
Where the README and reality differ
- README: storeMemory importance as float example 0.8 implied
What worked: importance must be int (schema expects int, e.g. 1) - probe error -32602 invalid number at importance
Check that it works
sessionmem --versionThe output should contain “1.10.1”.
Add it to your agent
claude mcp add sessionmem -- sessionmem runJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"sessionmem": {
"command": "sessionmem",
"args": [
"run"
]
}
}
}Add sessionmem run as an MCP server command in your AI coding client, then call its tools from there.
What it does
- Store project decisions across sessionsTested
How to use it
- Run
sessionmem runas an MCP server in your client. - Call the
storeMemorytool with a session ID,kindset todecision, and the decision text ascontent.
- Run
- Capture session events while you workTested
How to use it
- Run
sessionmem runas an MCP server in your client. - Call the
ingestSessionEventstool with a session ID and a list of events, each with an ID, event type and payload.
- Run
- Load relevant memories when a session startsTested
How to use it
- Run
sessionmem runas an MCP server in your client. - Call the
startup_inject_memoriestool with no arguments at the start of a session.
- Run
- Search stored memories by textTested
How to use it
- Run
sessionmem runas an MCP server in your client. - Call the
searchMemoryIndextool with your search text asquery.
- Run
How far pickfit got
macOS arm64
- Installs
- Connects
- 4 of 4 features work
- Works offline
Linux x86_64
- Installs
- Connects
- 0 of 4 features work
- Works offline
Other systems
Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- capture session events while you work
- summarize decisions and warnings into stored memories
- load relevant memories at next session start
An alternative to claude-mem.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
macOS arm64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version 1.10.1
An MCP client handshake over stdio listed 15 tools, and a call to storeMemory returned a result.
Differences the test machine hit
- README: npm install -g sessionmem without allowScripts warning
In the test: better-sqlite3 prebuild warning appears but install still succeeds and sessionmem --version works - README: sessionmem doctor expects PASS
In the test: doctor fails on auto-start, store and checkpoint until sessionmem ping initializes DB and autostart enabled - README: ingestSessionEvents example informal
In the test: tool requires events with id, eventType, payloadJson (JSON string) not tool/input shape
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 31 Oct 2026
- Version 1.10.1
An MCP client handshake over stdio listed 15 tools, and a call to startup_inject_memories returned a result.