https://github.com/g0t4/mcp-server-memory-file
Attempt to replicate ChatGPT like memory (text file) for Claude (and other MCP clients)
https://github.com/g0t4/mcp-server-memory-file
Last synced: 21 days ago
JSON representation
Attempt to replicate ChatGPT like memory (text file) for Claude (and other MCP clients)
- Host: GitHub
- URL: https://github.com/g0t4/mcp-server-memory-file
- Owner: g0t4
- Created: 2024-12-12T05:28:05.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2024-12-12T09:50:23.000Z (10 months ago)
- Last Synced: 2025-09-06T22:58:08.698Z (28 days ago)
- Language: TypeScript
- Size: 85 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- mcp-index - Memory Management Server - Manage and enhance chat experiences by allowing AI models to remember and recall information during conversations. Effortlessly add, search, delete, and list memories using a simple text file system to improve context retention and response relevance. (Developer Tools)
README
# mcp-server-memory
This is an [MCP](https://modelcontextprotocol.io/llms-full.txt) server to interact with a memory text file to help Claude with inter-chat context.
Each line is a memory.
These tools allow Claude (and other MCP clients) to manage memories mid-chat:
- `memory_add(memory: string)` - append the memory
- `memory_search(query: string)` - return matching memories (substring exact match) - later, might allow globs/regex
- `memory_delete(query: string)` - delete matching memories (substring exact match)
- `memory_list()` - return all memories
- FYI `memory_update` == `memory_delete` + `memory_add`
For example,
- I mention my name => "talking to Wes"
- metion daughter's age => "Wes's daughter is 8"
- say working on a typescript project => "working on typescript project"
- AND, this is critical, can be based on things Claude (assistant/LLM) says or does...
- Notably, tool use (i.e. `run_command`)... say there is a failure on a first attempt to use the tool (i.e. the `python` command isn't present) and then a subsequent tool use succeeds (i.e. using `python3` instead of `python`) => Claude can record "use python3, python is not present"...
- I ask Claude to get rid of memories about X => memory_delete(query: X)
- I correct my name => memory_search("oldname") + memory_delete(each matching record, or a common subset query) + memory_add("newname")
Then, when a new chat begins, Claude will automatically get recent memories (a subset or all) **OR** can ask for memories (some/more/all). And then can use those to influence responses/tools/etc.
## Design
A simple memory text file, why:
- [ChatGPT's memory](https://help.openai.com/en/articles/8590148-memory-faq) works well and is essentially a text file
- Maybe it's structured behind the scenes, however if you review your memory its presented as a text file.
- My testing of a similar reminders feature for `mcp-server-commands` worked great (when Claude had them).
- Unstructured text simplifies the tooling and parameters to basically managing a list of strings.
Cueing mechanism:
- It's also important to have a cue for the model to know when to store memories. This is a bit more unclear how best to do this but..
- Training: OpenAI acknowledges some training of models to know when to store memories. Just like models are trained for tool use.
- Prompt: A system prompt component likely contains a reminder to trigger storing memories.
- Tool alone: In my testing of Claude, with a tool spec alone, and even with hints/suggestions in tool responses, I couldn't get Claude to store memories. So this alone is not sufficient. Seems like Claude's training with tools is to only use them in pursuit of the prompt/request and thus why I believe adding a reminder/cue in a prompt component will work well.
## TODOs/Ideas
I have no idea if these are worth the time, just listing ideas here for the future. Perhaps in part to stop myself from working on them :)
- Recency factor: a way to rearrange memories based on recency?
- Order then becomes relevant for ambiguous memory queries (i.e. work on typescript project and python project then I ask to start a new project, could suggest the most recently used one?)
- Fade out old memories?