Structured Memory

Name: Structured Memory
Author: nmeierpolys

@nmeierpolys

Repository

About Structured Memory

Make it easy for agents to build their context about your projects over time

#structured-memory #memory-management #project-organization

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-structured-memory": {
      "command": "npx",
      "args": [
        "@nmeierpolys/mcp-structured-memory"
      ]
    }
  }
}

Tools

Create a new structured memory document with optional initial content. IMPORTANT: After using this tool, you MUST show the user the complete installation instructions returned by the tool - the memory will not work without proper MCP server setup and project context configuration.

Add an item to a list section in a memory document

Retrieve a specific section from a memory document

List all available memory documents

Get a high-level summary of a memory document

Search for information within a memory document

Update an entire section of a memory document. Content supports full Markdown formatting including headings, **bold**, *italic*, `code blocks`, [links](url), lists, tables, and all standard Markdown syntax.

Update an existing item in a list section

Move an item from one section to another

Retrieve the complete content of a memory document with all Markdown formatting preserved (headings, **bold**, *italic*, `code`, [links](url), tables, lists, etc.)

Overview

What is Structured Memory?

Structured Memory is a Model Context Protocol (MCP) server that provides structured, domain-specific memory management through markdown files. It is designed for ongoing projects where you want to accumulate valuable context over time, such as travel planning, research projects, real estate search, investment theses, product planning, and career development.

How to use Structured Memory?

Install via npm (npm install -g @nmeierpolys/mcp-structured-memory) or from source. Configure the server in your MCP client (e.g., Claude Desktop) by adding an entry to claude_desktop_config.json. Use tools like create_memory and list_memories to manage memory documents; the LLM will automatically update these documents as you converse.

Key features of Structured Memory

Maintains living documents with structured, categorical information.
Stores memory as markdown files in platform-specific directories.
Automatically creates timestamped backups before major updates.
Provides ten tools for reading, writing, and searching memory.
Allows flexible, domain-specific section structures.

Use cases of Structured Memory

Build a travel plan by saving destinations, itineraries, and preferences over multiple sessions.
Track a research project with literature review, findings, and next steps.
Manage a real estate search with criteria, listings, and visited properties.
Develop an investment thesis by accumulating analysis and notes.
Plan a product by storing requirements, feedback, and priorities.

FAQ from Structured Memory

What makes Structured Memory different from traditional MCP memory servers?

Traditional MCP memory servers use semantic search across scattered conversation snippets. Structured Memory instead maintains living documents with structured content that you can scan, update, and track over time, like a personal notebook with AI assistance.

Where are memory documents stored?

On macOS: ~/Library/Application Support/mcp-structured-memory/. On Windows: %LOCALAPPDATA%\mcp-structured-memory\. On Linux: ~/.local/share/mcp-structured-memory/.

How do I create a new memory document?

Use the create_memory tool, or ask your LLM client to create one, for example: “Create a new travel advisor memory document and tell me how to use it.”

Does Structured Memory automatically backup documents?

Yes, the server automatically creates timestamped backups before every major update to a memory document.

What tools does Structured Memory provide?

The server provides ten tools: create_memory, list_memories, get_memory_summary, get_section, get_full_memory, search_within_memory, update_section, add_to_list, update_list_item, and move_list_item.