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
- macOS:
-
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 storetags(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 contenttag(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