oh-memos-mcp

MCP Server for MemOS — Intelligent Memory Management for AI Assistants.

Node.js implementation. No Python required.

Quick Start

{
  "mcpServers": {
    "memos": {
      "command": "npx",
      "args": ["-y", "oh-memos-mcp"],
      "env": {
        "MEMOS_URL": "http://localhost:18000",
        "MEMOS_USER": "dev_user",
        "MEMOS_DEFAULT_CUBE": "dev_cube",
        "MEMOS_CUBES_DIR": "/path/to/data/memos_cubes"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | MEMOS_URL | Yes | — | MemOS API base URL | | MEMOS_USER | Yes | — | Default user ID | | MEMOS_DEFAULT_CUBE | Yes | — | Default memory cube ID | | MEMOS_CUBES_DIR | Yes | — | Path to cubes storage directory | | NEO4J_HTTP_URL | No | — | Neo4j HTTP endpoint for graph queries | | NEO4J_USER | No | — | Neo4j username | | NEO4J_PASSWORD | No | — | Neo4j password | | MEMOS_ENABLE_DELETE | No | false | Enable delete functionality |

Tools (18)

• memos_save — Save memories with explicit type classification
• memos_search — Semantic search with keyword reranking
• memos_search_context — Context-aware search with conversation history
• memos_list_v2 — List memories with compaction
• memos_get — Get full memory details by ID
• memos_get_stats — Memory type statistics
• memos_suggest — Smart search suggestions
• memos_context_resume — Recover context after compaction
• memos_trace_path — Trace reasoning paths between memories
• memos_get_graph — Knowledge graph with relationships
• memos_export_schema — Graph schema and statistics
• memos_impact — Forward blast radius analysis
• memos_calendar — Calendar view (project/student modes)
• memos_list_cubes — List available memory cubes
• memos_register_cube — Register a cube with the API
• memos_create_user — Create a MemOS user
• memos_validate_cubes — Validate and fix cube configs
• memos_delete — Delete memories (disabled by default)

Development

npm install
npm run dev    # Run with tsx (no build needed)
npm run build  # Compile to dist/

Requirements

• Node.js >= 18.0.0
• MemOS backend API running (Python FastAPI, port 18000)