Skip to content
MCP server

Hypermnesia MCP

Persistent, local-first memory for Claude Code with hybrid retrieval and cited sources

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
4.24.0
Listing updated
3 days ago

About Hypermnesia MCP

Hypermnesia MCP is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Hypermnesia is the MCP server form of the Cortex memory project. The README counts 36 implemented neuroscience-inspired mechanisms, 57 memory tools, 11 lifecycle hooks and a self-curating per-project wiki, all local and MIT licensed. Mechanisms named on the site include spreading activation, consolidation cycles and microglial pruning.

Retrieval fuses five signals, and the site reports 97.8 percent Recall@10 on LongMemEval-S for Cortex v4.20.0. A stated principle is that every claim ties back to a memory, file, commit or citation, and verification is deterministic, with no model judging another model.

It installs from PyPI over stdio. The maker is a one-person consultancy that also sells code migrations at fixed prices after a paid pilot; the memory server itself is one of several open-source components alongside a read-only visualiser and a session optimiser.

Install

Run in a terminal

claude mcp add hypermnesia-mcp -- uvx hypermnesia-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "hypermnesia-mcp": {
      "command": "uvx",
      "args": [
        "hypermnesia-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hypermnesia-mcp": {
      "command": "uvx",
      "args": [
        "hypermnesia-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "hypermnesia-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hypermnesia-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hypermnesia-mcp": {
      "command": "uvx",
      "args": [
        "hypermnesia-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "hypermnesia-mcp": {
      "command": "uvx",
      "args": [
        "hypermnesia-mcp"
      ]
    }
  }
}

What it does

Neuroscience-based memory
Implements 36 documented mechanisms such as consolidation and pruning.
Hybrid retrieval
Fuses five retrieval signals per the maker.
Lifecycle hooks
11 hooks tie memory into agent sessions.
Per-project wiki
Curates a wiki for each project automatically.
Cited facts
Claims link back to a memory, file, commit or citation.
Local and open source
MIT licensed and runs on your machine.

Good for

  • Let an agent remember decisions across Claude Code sessions
  • Keep per-project knowledge without a hosted service
  • Trace an agent's statement back to its source memory

Pricing

Open source

MIT licensed

Prices change. Check ai-architect.tools before you buy.

Hypermnesia MCP FAQ

Does it run locally?

Yes. The README describes it as local-first and open source under MIT.

How is it installed?

From PyPI as hypermnesia-mcp, over stdio.

Is the benchmark figure independent?

The 97.8 percent Recall@10 on LongMemEval-S is the maker's own reported result.

Is there a visualiser?

A separate read-only tool, hypermnesia-mcp-viz, is listed.

Is Hypermnesia MCP free?

Yes. Hypermnesia MCP is open source, so you can use and self-host it for free.

How do I add Hypermnesia MCP to Claude Code?

Run this command in your terminal: claude mcp add hypermnesia-mcp -- uvx hypermnesia-mcp

What are the best alternatives to Hypermnesia MCP?

The closest alternatives to Hypermnesia MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Hypermnesia MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools