Simple Memory

Provides persistent memory storage and retrieval for AI assistants via MCP with a web UI and memory tools.

javascript

1

GitHub Stars

javascript

Language

4 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": {
    "eragonht1-simple-memory-mcp": {
      "command": "node",
      "args": [
        "./start-mcp.js"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Simple Memory MCP provides persistent memory storage and retrieval for AI assistants using the Model Context Protocol. It enables you to store memories, fetch memory lists, and access specific memory contents through a local server with a web-based management interface, while supporting multiple AI assistants sharing the same MCP server instance.

How to use

You will run a local MCP server and connect your AI assistant to it. Use the available tools to store memories, list memories, and retrieve memory contents. You can also open a web-based management interface that lets you create, view, edit, and organize memories with a clear visual workflow.

How to install

Follow these steps to set up the memory MCP server from scratch.

Prerequisites include Node.js and basic tooling on your operating system.

Clone the project and install dependencies, then initialize the database before starting the server.

Install and start commands

# Clone the repository
git clone https://github.com/eragonht1/simple-memory-mcp.git

# Enter the project directory
cd simple-memory-mcp

# Install dependencies
npm install

# Initialize the database
npm run init-db

# Start the MCP server
npm start

# Start the Web interface (recommended)
node start-web.js
# or
npm run web

Configuration and quick setup

Use the universal configuration template to connect an AI assistant supporting MCP. This defines how to run the MCP server from another process or client.

{
  "mcpServers": {
    "simple-memory": {
      "command": "node",
      "args": ["./start-mcp.js"],
      "cwd": "/path/to/your/simple-memory-mcp"
    }
  }
}

Available tools

store_memory

Store a new memory by providing a title and content; the server persists the memory for later retrieval.

list_memory_titles

Retrieve a list of all memory titles stored in the MCP server.

get_memory_by_title

Fetch the complete content of a memory by its title.

delete_memory

Remove a specific memory from storage.

open_memory_web

Open the memory management web interface with automatic browser launch.