Quickstart

Requirements

Node.js 18 or newer (20 or newer recommended, since Node 18 is end-of-life)
An MCP client that can run a stdio server

On Node 18, npm prints an EBADENGINE warning for @hono/node-server, a dependency of the MCP SDK’s HTTP transport that this stdio server never loads. The warning is harmless, but installs with engine-strict=true (or Yarn 1) need Node 20 or newer, or engine checks turned off.

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}

Start

Product

Reference

Requirements

Install

Add the MCP server

Use a custom memory file

Try the tool

​Requirements

​Install

​Add the MCP server

​Use a custom memory file

​Try the tool

Requirements

Install

Add the MCP server

Use a custom memory file

Try the tool