Memory MCP Server

A Model Context Protocol (MCP) server that provides tools for storing, retrieving, and managing memories saved to a local file.

Features

Store text memories with optional tags
Search memories by text or tags
Retrieve all stored memories
Delete specific memories
View tag usage statistics
Persistent storage in a local JSON file

Installation

From Source

Clone this repository
Install dependencies:
npm install
Build the server:
npm run build

Usage

Running the Server

Run the server with:

npm start -- [storage-path]

Where storage-path is the directory where you want to store the memories file (defaults to the current directory).

Setting up with Claude for Desktop

To use this server with Claude for Desktop:

Open your Claude for Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the server configuration:

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

Restart Claude for Desktop. You may need to force-quit any running Claude processes for the changes to take effect.

Available Tools

The server exposes the following tools:

`store-memory`

Stores a new memory.

Parameters:

content (string, required): The text content to store
tags (array of strings, optional): Tags to categorize the memory

`search-memories`

Searches for memories.

Parameters:

searchTerm (string, optional): Text to search for in the memory content
tag (string, optional): Filter memories by this tag

`get-all-memories`

Retrieves all stored memories.

Parameters: None

`delete-memory`

Deletes a memory by ID.

Parameters:

id (string, required): ID of the memory to delete

`get-tags-summary`

Gets a summary of all used tags.

Parameters: None

Example Usage in Claude

Here are some example queries to use with Claude:

"Store this information: The project deadline is March 15, 2025. Tags: work, deadlines"
"What memories do I have related to work?"
"Show me all my memories"
"Delete memory with ID abc123"
"What tags have I used in my memories?"

File Structure

The server stores memories in a file named memories.json in the specified storage directory.

License

MIT

Memory MCP Server

Integrations