<- all tokdocs

Claude-Mems: Giving Claude Code Access to Its Own Conversation History

Watch on TikTok

View on TikTok ->

Claude Code writes every conversation you have to a local project folder on your machine, but it cannot look back at those conversations in future sessions. Claude-mems is an MCP server that gives Claude read access to its own past conversation logs, providing a form of continuity between sessions.

The Problem

Every Claude Code session starts cold. You say "continue where we left off" and Claude has to ask you to re-explain everything. Context evaporates between sessions.

But Claude Code already writes complete conversation logs to ~/.claude/projects/. Every conversation you have ever had with every project is already stored on your computer. Claude just cannot access those files by default.

GitHub page for claude-mems showing the project title "Give Claude its memories back" and description of the MCP server

How It Works

Claude-mems is an MCP server that gives Claude read access to those existing conversation logs. The tool lets Claude look up what actually happened in previous sessions instead of starting from zero.

The project's creator tested it by having Claude write a message to its future self. In a new session, Claude used the tool to search its history and found its own message. The approach is grounded: Claude either finds the conversation or it does not. There is no confabulation of false memories because it is reading actual logs.

README showing "The Solution" section explaining how Claude Code's conversation logs at ~/.claude/projects/ are made accessible

Philosophy: Notes, Not Memory

The creator is clear that this is not "long-term memory" in any deep sense. It is notes. Claude does not remember previous sessions. It looks them up. That distinction matters because it means Claude cannot confabulate false memories. It either finds the conversation or it does not.

The goal is grounded continuity: being able to reference what actually happened, quote actual decisions, and pick up where you left off.

README showing the Philosophy section: "This isn't long-term memory in any mystical sense. It's notes."

Installation

Installation is a single command. It is an NPX package on NPM, so it downloads quickly and requires no special permissions:

claude mcp add claude-mems

Key Takeaways

  • Claude Code already stores all your conversation history locally in ~/.claude/projects/
  • Claude-mems is an MCP server that gives Claude read access to those logs for cross-session continuity
  • This is notes retrieval, not true memory; Claude looks up past conversations rather than remembering them

Resources

Published May 25, 2026. Writeup generated from a favorited TikTok.