Memory Nexus MCP

A self-nourishing AI memory system exposed as an MCP (Model Context Protocol) server.

Give Claude Code persistent memory across sessions.

Features

• Semantic Memory: Understands meaning, not just keywords
• Self-Nourishing: Gets smarter with every query
• Local-First: Runs entirely on your machine with SQLite
• MCP Integration: Works directly with Claude Code

Quick Start

1. Install

npm install -g memory-nexus-mcp

Requirements: Python 3.10+ (automatically detected)

2. Add to Claude Code

claude mcp add memory-nexus -- npx memory-nexus-mcp

3. Use in Claude Code

Once connected, Claude Code can:

# Remember something
"Remember that we decided to use PostgreSQL for the database"

# Recall context
"What do you remember about our database decisions?"

# Get session context
"Load the context for this project"

MCP Tools

| Tool | Description | |------|-------------| | remember | Store something in memory | | recall | Search memory semantically | | connect_memories | Link related memories | | get_session_context | Load context for a session | | forget | Remove a memory | | memory_stats | Get memory statistics | | list_contexts | List memory categories |

Configuration

Set custom data directory:

MEMORY_DATA_DIR=/path/to/data npx memory-nexus-mcp

Default: ~/.memory-nexus/data

How It Works

Memory Nexus uses a three-tier architecture inspired by cognitive science:

• Temporal: When things happened (SQLite)
• Semantic: What things mean (local embeddings)
• Graph: How things connect (SQLite)

Every query teaches the system. It learns patterns and predicts what you'll need.

License

MIT

Author

Diana Malone