save-memoriesLABSCO SUMMARY
Context that outlives the conversation window.
The database is the point: memories sit in MongoDB you control, so they survive a client restart, a new project and a different editor. Note that saving overwrites and appending does not — which of the two you call is the difference between adding a fact and replacing everything you had.
What it is
Persistent storage for the things you would otherwise re-explain. Memories live in MongoDB rather than the session, and the assistant can append to them, read them back, replace them or clear them out.
What you get
- Memories saved to the database, and read back in a later session
- Appending new memories without overwriting what is already stored
- A full reset when the stored set has gone stale
- Archiving of conversation context with tags, and retrieval of the relevant parts
- Relevance scoring and summaries over what has been archived
Requirements
A MongoDB instance and its connection string in the environment. Node.js 18 or newer with npm.
Setup effort
One command — npm install -g @jamesanz/memory-mcp
USE CASES
01
Not re-explaining the project every morning
Read the stored memories at the start of a session so the assistant opens with the decisions and constraints you established, rather than from nothing.
02
Recording a decision the moment it is made
Append the new fact without touching what is already there — the safe call when you are adding to a set you care about.
03
Replacing a memory set that has gone stale
Save over the stored set when the old one describes a project that has moved on. This overwrites, so it is the call to reach for deliberately.
04
Starting clean
Clear the stored memories when you are handing the setup to a different project, and confirm what is left by reading back.
10 tools
Listed in project docs. Your client may show a different list.
get-memoriesadd-memoriesclear-memoriesarchive-contextretrieve-contextscore-relevancecreate-summaryget-conversation-summariessearch-context-by-tagsBEFORE YOU INSTALL
What to know first
Tools you get
10 tools named in the project's documentation.
Requires
- Node.js 18+ and npm
- A MongoDB database, reached through MONGODB_URI (default mongodb://localhost:27017)
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g @jamesanz/memory-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · TERMINAL
git clone https://github.com/JamesANZ/memory-mcp.git
cd memory-mcp
npm install
npm run buildCLAUDE DESKTOP · JSON
{
"mcpServers": {
"memory-mcp": {
"command": "node",
"args": [
"<YOUR_PATH_TO_MEMORY_MCP>/build/index.js"
],
"env": {
"MONGODB_URI": "mongodb://localhost:27017"
}
}
}
}<YOUR_PATH_TO_MEMORY_MCP> is the full path of your memory-mcp clone. MONGODB_URI points at a MongoDB on this computer (localhost); if yours is elsewhere, use its connection string. Restart Claude Desktop afterwards.
Cursor — One Click
CURSOR — ONE CLICK
cursor://anysphere.cursor-deeplink/mcp/install?name=memory-mcp&config=eyJtZW1vcnktbWNwIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15IiwiQGphbWVzYW56L21lbW9yeS1tY3AiXX19
