Memory
About
Provides structured memory management for project-based work through markdown file storage, enabling persistent context across chat sessions with efficient Lunr.js indexing for retrieval, updating, and relating memories.
Details
- Author
- ebailey78
- Repository
- ebailey78/mcp-memory
- GitHub stars
- 3
- Categories
- Productivity, Developer Tools, Design, Workplace, File Management, AI, Community, Search, Knowledge Base, Communication, Infrastructure, Project Management
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MemoryCommand (node, npx, python, etc.)nodeArguments-
Argument 1
path/to/mcp-memory/dist/index.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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"
}
}
}
}
npm install
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"memory": {
"env": {},
"args": [
"path/to/mcp-memory/dist/index.js"
],
"command": "node"
}
}
}Linux
{
"env": [],
"args": [
"path/to/mcp-memory/dist/index.js"
],
"command": "node"
}Macos
{
"env": [],
"args": [
"path/to/mcp-memory/dist/index.js"
],
"command": "node"
}Windows
{
"env": [],
"args": [
"/c",
"node",
"path/to/mcp-memory/dist/index.js"
],
"command": "cmd"
}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
1. Setup: When starting a new project with Claude, have it create a memory store in your project directory
2. Ongoing Work: As you work with Claude, it will save important information to the memory store
3. Continuity: In future sessions, Claude can retrieve relevant memories to maintain context
4. 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
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
