Memory

Provides a project-scoped memory store for Claude Desktop with structured memories, a Lunr.js index, and retrieval across sessions.

typescript

6

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You are setting up an MCP server that provides a dedicated memory store within each project directory for Claude Desktop. It saves important details from conversations, indexes memories for fast retrieval, and helps maintain project context across sessions so you can build a growing knowledge base around your work.

How to use

Install and run the memory MCP alongside Claude Desktop to create a per-project memory store. Claude will automatically create and update memories as you work, and you can retrieve relevant memories in future sessions to maintain project context. You can organize memories by entities, concepts, and sessions, search by content or tags, and build relationships between memories for a richer knowledge base.

How to install

# Install dependencies
npm install

# Build the memory MCP
npm run build

# Start the memory MCP
npm start

# Development mode (watch for changes)
npm run dev

Additional configuration and usage notes

Configure the server to run with Claude Desktop by adding a memory MCP entry to your claude_desktop_config.json. The server runs as a local process and is accessed via a standard input/output (stdio) interface.

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

Environment variables and custom memory directory

You can direct memories to a custom directory by setting MEMORY_DIR in the memory MCP configuration.

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

Available tools

storeMemory

Save a memory item into the project memory store with optional categorization and tags.

indexMemories

Create and update a Lunr.js index to enable fast search across all memories.

tagMemory

Apply tags to memories to enable organized retrieval by topic, entity, or concept.

searchMemories

Query memories by content, tags, or type to retrieve relevant information quickly.

relateMemories

Establish relationships between memories to build a richer knowledge graph for the project.