MCP Memory Server

A Model Context Protocol (MCP) server for Claude Desktop that provides structured memory management across chat sessions, specifically designed for project-based work.

Project-Focused Memory Management

This MCP server is specifically designed to help Claude maintain context and knowledge within project directories when used with Claude Desktop. It allows Claude to:

Create a memory store within your project directory
Save important information discovered during conversations
Retrieve relevant memories in future sessions
Build a comprehensive knowledge base about your project over time

This approach is ideal for long-term projects where maintaining context between sessions is crucial, such as software development, research, writing, or any collaborative work with Claude.

Features

Store memories as structured markdown files
Index memories using Lunr.js for efficient retrieval
Tag and categorize memories
Create relationships between memories
Search memories by content, tags, or type
Build memory stores in specified directories

Memory Structure

Memories are stored in a hierarchical structure within your project:

/your-project-directory
  /memory                # Memory store created by Claude
    /entities/           # Information about specific entities (people, projects, etc.)
    /concepts/           # Abstract concepts or knowledge
    /sessions/           # Session-specific memories
    /index.json          # Lunr.js search index
    /metadata.json       # Overall memory metadata
    /README.md           # Auto-generated documentation

This structure keeps all project-related memories organized and accessible within your project directory.

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["path/to/mcp-memory/dist/index.js"]
    }
  }
}

You can also set a custom memory directory using an environment variable:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["path/to/mcp-memory/dist/index.js"],
      "env": {
        "MEMORY_DIR": "/path/to/custom/memory/directory"
      }
    }
  }
}

Project Workflow

Setup: When starting a new project with Claude, have it create a memory store in your project directory
Ongoing Work: As you work with Claude, it will save important information to the memory store
Continuity: In future sessions, Claude can retrieve relevant memories to maintain context
Knowledge Building: Over time, Claude builds a comprehensive knowledge base about your project

This workflow ensures that Claude maintains context and knowledge specific to each project, making it more effective as a long-term collaborator.

Claude Project Instructions

This repository includes an instructions_template.md file that provides a comprehensive template for Claude project instructions. You can customize this template for your specific projects to help Claude effectively use the memory system.

The template includes:

Memory system setup instructions
Memory retrieval process
Memory creation guidelines
Memory organization system
Memory maintenance procedures
Conversation workflow
Best practices

Development

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

# Development mode (watch for changes)
npm run dev

Implementation Details

This server is built using:

The official Model Context Protocol (MCP) SDK
TypeScript for type safety
Lunr.js for memory indexing and search
Zod for schema validation

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.

Related Resources

Reddit Discussion about this server

Related MCP Servers

PostHog MCP Serverofficial
PostHog
A
security
A
license
A
quality
A Model Context Protocol server that enables Claude Desktop users to interact directly with PostHog, allowing them to view projects and create annotations through natural language commands.
Last updated -
2
10
Python
MIT License
Claude TypeScript MCP Servers
ukkz
A
security
A
license
A
quality
A collection of Model Context Protocol servers that enable Claude Desktop to provide development assistance capabilities with filesystem, Git, shell command, and web search functionality without incurring API usage costs.
Last updated -
2
14
TypeScript
MIT License
Zulip MCP Server
Monadical-SAS
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Zulip workspaces, supporting capabilities such as posting messages, listing channels, sending direct messages, and accessing conversation history.
Last updated -
JavaScript
Apache 2.0
MCP TaskManager
Rudra-ravi
-
security
A
license
-
quality
A Model Context Protocol server that allows Claude Desktop to manage and execute tasks in a queue-based system, supporting planning, execution, and completion phases.
Last updated -
322
2
TypeScript
MIT License

View all related MCP servers

MCP Memory Server