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

1. Clone this repository
2. Install dependencies:
   npm install
3. Build the server:
   npm run build

Usage

Running the Server

Run the server with:

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:

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

3. 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