memory-mcp

Persistent memory for AI agents over the Model Context Protocol (MCP). Filesystem-backed, dependency-light, with keyword search — so an agent can remember things across sessions without a database, embeddings, or API keys.

Why

Most agents forget everything between runs. memory-mcp gives any MCP-compatible client (Claude Desktop, Claude Code, and others) five simple tools to write, read, search, list, and delete memories that persist on disk as plain JSON. The storage layer is standard-library only and independently tested, so it's easy to audit and hard to break.

Tools

Install

pip install git+https://github.com/M-Ashrey/memory-mcp

Requires Python 3.10+.

Use with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp"
    }
  }
}

By default, memories are stored under a local file resolved from the MEMORY_MCP_PATH environment variable. Set it to control where data lives:

{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp",
      "env": { "MEMORY_MCP_PATH": "/path/to/memory.json" }
    }
  }
}

Develop

git clone https://github.com/M-Ashrey/memory-mcp
cd memory-mcp
pip install -e ".[dev]"
pytest

The store logic (memory_mcp/store.py) has no third-party dependencies and its tests never import the MCP server, so the test suite runs even without the mcp SDK installed.

Related

Part of a small set of AI-agent tooling — see also the Claude MCP starter kit.

License

MIT