Durandal Memory MCP Server

Zero-config AI memory system for Claude Code via Model Context Protocol (MCP)

Give Claude Code persistent memory that remembers across sessions. Store information, search memories, and maintain context automatically.

Quick Start

1. Install

npm install -g durandal-memory-mcp

2. Add to Claude Code

# For Windows
claude mcp add durandal-memory -- cmd /c durandal-mcp

# For macOS/Linux
claude mcp add durandal-memory -- durandal-mcp

3. Verify Setup

claude mcp list
# Should show: durandal-memory: ... - Connected

That's it! No configuration files, no API keys, no database setup required.

How to Use

Just talk naturally to Claude Code. The memory system activates automatically:

Store Memories

• "Remember that I prefer React with TypeScript"
• "Store this API endpoint for later: https://api.example.com"
• "I need you to remember my coding style preferences"

Retrieve Memories

• "What do you remember about my preferences?"
• "Search my memories for React"
• "Do you recall anything about TypeScript?"

Get Context

• "What context do you have about this project?"
• "Show me recent memories"
• "What's in my memory system?"

Optimize Memory

• "Optimize my memories"
• "Clean up memory storage"

Features

• Persistent Memory: Remembers across Claude Code sessions
• Smart Search: Find information using natural language
• Auto-Categorization: Organizes memories by type and importance
• Zero Configuration: Works immediately after installation
• SQLite Database: Automatically created on first use
• Local Storage: All data stays on your machine

MCP Tools Available

The server exposes these tools to Claude Code:

• store_memory - Store content with metadata
• search_memories - Search with filters and queries
• get_context - Retrieve recent memories and statistics
• optimize_memory - Run memory system optimization
• get_status - Display system status dashboard
• configure_logging - Change log levels at runtime
• get_logs - Retrieve session history for debugging

File Structure

After installation, the server creates:

• durandal-mcp-memory.db - SQLite database (auto-created)
• ~/.durandal-mcp/logs/ - Session history logs (auto-created)
• Memory data organized by:
  • Content and metadata
  • Categories and keywords
  • Importance scores
  • Timestamps

Configuration (Optional)

The system works with zero configuration, but you can customize:

# Copy the minimal config template
cp node_modules/durandal-memory-mcp/.env.mcp-minimal .env

# Edit if needed (all settings are optional):
DATABASE_PATH=./my-custom-memory.db
CONSOLE_LOG_LEVEL=warn  # Terminal output: error, warn, info, debug
FILE_LOG_LEVEL=info     # Log file detail: error, warn, info, debug

Advanced Usage

Check Server Status

durandal-mcp --help

Run Standalone Test

durandal-mcp --test

Configure Logging Levels

durandal-mcp --configure

Different Working Directory

The MCP server creates its database in the current working directory where Claude Code is running.

Troubleshooting

MCP Server Not Connecting

# Check if server is configured
claude mcp list

# Remove and re-add if needed
claude mcp remove durandal-memory
claude mcp add durandal-memory -- cmd /c durandal-mcp

Database Issues

# The database is auto-created, but if you have permission issues:
# Make sure the directory is writable
# Delete the .db file to recreate: rm durandal-mcp-memory.db

Memory Not Working

• Make sure you're using natural language (not technical commands)
• Try: "Remember this:" followed by your content
• Check that Claude Code shows the MCP server as connected

Debugging Issues

• Session logs are stored at: ~/.durandal-mcp/logs/durandal-YYYY-MM-DD.log
• Send log files to support for assistance
• Use get_logs MCP tool to retrieve recent entries
• Configure log levels with configure_logging MCP tool

Requirements

• Node.js: 18.0.0 or higher
• Claude Code: Latest version
• Operating System: Windows, macOS, or Linux

Support

• Issues/Feedback: [email protected]

License

MIT License - see LICENSE file for details.

Zero-config persistent memory for Claude Code