Skip to content

← All guides

Archive memory guide

This Claude Code guide is preserved for existing users. Memory is now supporting infrastructure under the production-action control product.

How to Add Persistent Memory to Claude Code

Claude Code is Anthropic's CLI coding assistant. One command adds persistent memory via the Novyx MCP Server. Claude Code remembers your projects across sessions.

The Problem

  • Claude Code starts fresh every session
  • You re-explain project structure and conventions each time
  • Past coding decisions aren't accessible
  • No rollback for bad suggestions that get committed

Setup

Install and register in one step:

bash
pip install novyx-mcp
bash
claude mcp add novyx-memory -- python -m novyx_mcp

Optional — add an API key for cloud sync:

bash
export NOVYX_API_KEY="YOUR_API_KEY"

That's it. Claude Code now has access to MCP memory tools. Local SQLite mode works without an API key — add one later to sync across machines.

What You Get

91
Memory Tools
6
Resources
3
Prompts

Key Capabilities

Remember project decisions

Claude Code stores architecture choices, coding conventions, and key decisions permanently.

Recall context instantly

"What did we decide about the database schema?" — semantic search across all past sessions.

Recover mistakes

Use supported recovery workflows when project memory goes off track.

Context Spaces

Organize memories by project or topic. Keep different codebases isolated.

Tools & Resources

CategoryAvailableTier
Core Memoryremember, recall, forget, list_memories, memory_stats, rollback, audit, link_memories, add_triple, query_triplesFree+
Context Spacescreate_space, list_spaces, space_memories, update_space, delete_space, share_spaceFree+
Replayreplay_timeline, replay_snapshot, replay_lifecycle, replay_diffFree+
Experimental maintenanceOptional memory-maintenance helpers where enabledWhere enabled
Resourcesnovyx://memories, novyx://memories/{id}, novyx://stats, novyx://usage, novyx://spaces, novyx://spaces/{id}Free+
Promptsmemory-context, session-summary, space-contextFree+

See the full MCP docs on the Integrations page.

Frequently Asked Questions

How do I add persistent memory to Claude Code?

Run "pip install novyx-mcp" then "claude mcp add novyx-memory -- python -m novyx_mcp". Claude Code gets MCP memory tools so sessions can persist across compacts, restarts, and new conversations.

Does Claude Code remember between sessions?

Not by default. Claude Code loses context on /compact, restart, or new session. The Novyx MCP server gives Claude Code persistent memory that survives all of these — your agent picks up where it left off.

What is the best MCP server for Claude Code memory?

novyx-mcp provides MCP access for persistent memory, audit context, knowledge graphs, and governed actions. It runs locally with SQLite (zero config) or syncs to the cloud with an API key.

Can I use Novyx MCP without an API key?

Yes. novyx-mcp runs locally with SQLite out of the box — no API key, no account, no limits. Add a Novyx API key later to sync across machines and unlock cloud features.

Start with the production-action gate

For the current product path, start with a governed production action.

Run the gate