Requirements

  • Node.js 18 or newer
  • An MCP client that can run a stdio server

Install

Install globally:
npm install -g mcp-prose-memory
Or run it directly with npx:
npx mcp-prose-memory

Add the MCP server

Add a server entry to your MCP client config:
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["mcp-prose-memory"]
    }
  }
}
Restart the client after saving the config.

Use a custom memory file

By default, memory is stored at ~/.mcp-prose-memory/memory.json. Set MEMORY_PATH when you want the memory file somewhere else:
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["mcp-prose-memory"],
      "env": {
        "MEMORY_PATH": "/path/to/your/memory.json"
      }
    }
  }
}

Try the tool

Once connected, call the memory tool:
{"command": "add", "section": "personal", "fact": "Prefers concise answers"}
Then view stored memory:
{"command": "view"}
For compact assistant memory, use structured facts:
{"command": "upsert", "section": "user_preferences", "key": "answer_style", "value": "Prefers concise answers"}
For startup context with a small prompt budget:
{"format": "compact", "sections": ["user_preferences"], "maxChars": 1500}