Nova Memory

Local-first persistent memory for AI assistants. Store context across sessions with SQLite.

What is Nova Memory?

Nova Memory is an MCP (Model Context Protocol) server that gives AI assistants persistent memory. It stores your project context, decisions, and knowledge locally in SQLite - no cloud, no telemetry. Your data stays on your machine.

Features

• 22 MCP tools for memory, search, analysis, and task management
• Store and search memories with BM25 full-text search
• Knowledge graph with relationship traversal
• Task management with phases and progress tracking
• Multi-project support with cross-project queries
• Enable/disable individual tools via configuration
• Complete TypeScript implementation with Zod validation

Installation

npm install -g @nova-mcp/mcp-nova

Setup

Claude Desktop

Add to your config file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nova-memory": {
      "command": "npx",
      "args": ["@nova-mcp/mcp-nova"]
    }
  }
}

Claude Code

claude mcp add nova-memory -- npx @nova-mcp/mcp-nova

Available Tools

Memory Tools (8)

Tool	Description
store_memory	Store content with type, tags, and path tracking
memory_search	Full-text search with BM25 ranking
memory_query	Filter by type, tags, project, or path
memory_stats	Storage statistics and memory counts
memory_delete	Remove memories by ID
memory_tags	List all tags with usage counts
memory_export	Export memories as JSON or markdown
memory_import	Bulk import memories from JSON

Search Tools (4)

Tool	Description
search_semantic	Semantic similarity search
search_patterns	Find recurring patterns in memories
search_temporal	Time-based memory analysis
search_relationships	Explore memory connections

Analysis Tools (4)

Tool	Description
analysis_conflicts	Detect contradictions between memories
analysis_memory_map	Generate memory visualization
analysis_anomalies	Find unusual patterns
analysis_forecast	Predict memory patterns

Task Tools (3)

Tool	Description
task_management	Create tasks, phases, track progress
task_board	Visual overview of pending/active/completed
task_insights	AI-powered task analytics

Advanced Tools (2)

Tool	Description
knowledge_graph	Build and query relationship graphs
project_profile	Store project architecture and stack info

Maintenance Tools (1)

Tool	Description
memory_compact	Optimize and compact storage

Configuration

Create .nova/config.json in your project root:

{
  "storage": {
    "mode": "project"
  },
  "features": {
    "taskManagement": true,
    "knowledgeGraph": true
  },
  "tools": {
    "search_patterns": true,
    "analysis_conflicts": true,
    "project_profile": true
  }
}

Storage Modes

Mode	Description
project	Store in .nova/memory.db (default)
global	Store in ~/.nova-memory/memory.db
multi	Query across multiple project databases

Multi-Project Configuration

{
  "storage": {
    "mode": "multi",
    "multiProject": {
      "enabled": true,
      "includePaths": ["~/projects/api", "~/projects/web"]
    }
  }
}

Storage Location

All data stored locally in SQLite:

• Project mode: .nova/memory.db in project root
• Global mode: ~/.nova-memory/memory.db in home directory

No cloud services. No external API calls. No telemetry.

Troubleshooting

• Tools not showing: Restart Claude Desktop/Code after installation
• Command not found: Run npm install -g @nova-mcp/mcp-nova or check PATH
• NVM users: Use full path to node in MCP config
• Permission errors: Ensure write access to .nova or home directory
• Version check: Run mcp-nova --version to verify installation

Links

• npm package
• GitHub repository
• Report issues

License

MIT