iCog

COGNITIVEX · GLOSSARY

Anthropic’s memory tool, explained

What the Claude memory tool actually does, how it works, and where a file-backed tool ends and a Large Cognition Model begins.

THE SHORT ANSWER

It is a tool, not a brain.

Anthropic’s memory tool is a client-side tool you expose to Claude through the Messages API. It defines a small set of file operations (create, read, edit, and delete) that act on a dedicated memory directory. When Claude decides something is worth keeping, it calls the tool to write a file; on later turns it can call the tool again to list and read those files back into context.

The important part: your application owns the storage.Anthropic specifies the tool’s shape; you implement where the files live, how long they persist, and who they belong to. The model never reaches a database directly. It emits tool calls, and your handler reads and writes on its behalf. That makes the memory tool a clean primitive, and also a deliberately thin one.

HOW IT WORKS

The loop, step by step.

  1. You declare the memory tool alongside your other tools in the API request and run a tool-execution loop.
  2. Before answering, Claude can list and read existing memory files to recover context from earlier sessions.
  3. During or after a turn, Claude writes new files (notes, preferences, task state) into the memory directory via tool calls.
  4. Your handler persists those files wherever you choose (disk, object storage, a per-user bucket) and replays them on the next request.

Because memory lives in files outside the prompt, it pairs naturally with context management: you can keep the working context lean and let Claude pull only the memory it needs. It is a genuinely useful pattern for agents that span many sessions. The same design also draws the line at what it is: a place to put text and get it back. The model decides what to write; nothing decides what is worth keeping, what contradicts what, or what should fade.

MEMORY TOOL VS. THE LCM

Storage Claude can call vs. memory that thinks.

A memory tool is a faithful filing cabinet: it stores exactly what the model puts in and returns exactly that. CognitiveX builds a different thing, the Large Cognition Model (LCM). The line we hold: the memory is the model.Instead of an LLM doing query → model → response → forget, the LCM closes the loop: query → living memory → reasoning → learning → evolution.

CapabilityAnthropic memory toolCognitiveX LCM
What it isA client-side file tool Claude can callA hosted cognitive layer behind any model
StorageYou implement and host itHosted memory backbone, served over MCP + HTTP
Memory structureFlat files; whatever Claude writesFour tiers: semantic, episodic, procedural, foundational
RetrievalList and read files by nameSalience-ranked recall by meaning and depth
ConsolidationNone; files accumulateOvernight dream consolidation; pattern detection
ForgettingManual deleteSalience decay and reflection prune what fades
Cross-modelTied to your Claude integrationSame memory recalled by any agent over MCP

None of this is a knock on the memory tool. It is a well-scoped primitive, and for many agents it is exactly enough. The difference is altitude. A tool gives the model a place to put text. An LCM gives every model a memory that types, ranks, consolidates, reflects, and forgets on its own, then shares that one backbone across Claude, your other agents, and the apps built on top of it. If you are wiring memory into Claude specifically, see the Claude Code integration: the same hosted backbone, installed as an MCP server.

FAQ

Common questions

What is Anthropic's memory tool?

It is a client-side tool that lets Claude read and write files in a dedicated memory directory. Anthropic defines the tool interface; your application stores the files and replays them into context on later turns. Claude decides what to save and when to look it up.

Does the memory tool give Claude long-term memory automatically?

No. The tool gives Claude the ability to write to and read from a store you control. Persistence, scoping, and retrieval are your responsibility. There is no built-in consolidation, ranking, or forgetting. What Claude writes is what you get back.

Is the memory tool the same as the /memories feature in Claude.ai?

No. The consumer memory in the Claude apps is a product feature. The memory tool is a developer primitive you wire into the Messages API for your own agents.

How is an LCM different from a memory tool?

A memory tool is storage Claude can call. A Large Cognition Model is a memory that reasons about itself. It types, ranks, consolidates, and forgets memories on its own, and serves the same backbone to any model or agent over MCP.

Give every model a memory that learns.

Not another memory tool. It is the cognitive infrastructure that makes every LLM smarter.

Start building →Try iCog →