@chaoszh/mnemo-mcp

MCP stdio server for Mnemo — exposes persistent memory tools to Claude Desktop and Claude Code via the Model Context Protocol.

Quick start

No install needed. Configure your MCP client to spawn the server with npx:

Claude Desktop

Edit ~/AppData/Roaming/Claude/claude_desktop_config.json (Windows) or ~/.config/claude/claude_desktop_config.json (macOS/Linux):

{
  "mcpServers": {
    "mnemo": {
      "command": "npx",
      "args": ["@chaoszh/mnemo-mcp"],
      "env": {
        "DATABASE_URL": "postgresql://postgres:password@localhost:5432/postgres",
        "MNEMO_AGENT_ID": "claude",
        "MNEMO_GEMINI_API_KEY": "your-gemini-key"
      }
    }
  }
}

Claude Code

{
  "mcpServers": {
    "mnemo": {
      "command": "npx",
      "args": ["@chaoszh/mnemo-mcp"],
      "env": {
        "DATABASE_URL": "postgresql://postgres:password@localhost:5432/postgres",
        "MNEMO_AGENT_ID": "claude-code",
        "MNEMO_GEMINI_API_KEY": "your-gemini-key"
      }
    }
  }
}

Environment variables

| Variable | Required | Description | |---|---|---| | DATABASE_URL | ✅ | Postgres connection string | | MNEMO_AGENT_ID | ✅ | Unique identifier for this agent | | MNEMO_GEMINI_API_KEY | ✅ | Gemini API key for embeddings | | MNEMO_DEFAULT_SEARCH_LIMIT | — | Max results from search_memories (default 5) | | MNEMO_DEFAULT_SESSION_LIMIT | — | Max results from list_sessions (default 10) | | MNEMO_MEMORY_TTL_DAYS | — | Auto-delete memories older than N days |

Tools exposed

| Tool | Description | |---|---| | save_memory | Persist a memory | | search_memories | Find memories by semantic similarity | | delete_memory | Delete a memory by ID | | update_memory | Correct or amend an existing memory |

Database setup

Requires PostgreSQL with pgvector. See the devkit for a Docker Compose setup, or apply migrations manually:

for f in db/*.sql; do psql "$DATABASE_URL" -f "$f"; done