mcpField
M
MCP Memory Server

MCP Memory Server

Local
github.com/grizzlypeaksoftwareMemory & Knowledge0Updated 85w ago
Repository

About MCP Memory Server

MCP Memory Server is a file-based MCP server for clients that need to save and retrieve text memories. It supports tags, search, and persistent local storage.

Key features

  1. 01Store text memories with optional tags
  2. 02Search memories by text or tag
  3. 03Retrieve all memories
  4. 04Delete memories by ID
  5. 05View tag usage statistics
  6. 06Persist data in a local JSON file

Use cases

  1. 01Record and categorize project details
  2. 02Find saved memories by keyword or tag
  3. 03Remove a memory and review tag usage

MCP support

It exposes tools to MCP clients for storing, searching, retrieving, and deleting memories, as well as reviewing tag statistics.

#memory#claude

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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:

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:

  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:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": [
        "/path/to/mcp-memory-server/build/index.js",
        "/path/to/storage/directory"
      ]
    }
  }
}
  1. 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.