# Hypermnesia MCP Viz

> Hypermnesia MCP Viz is an open-source MCP server for knowledge and memory. Read-only visual explorer for Cortex memory, sessions, traces and codebase graphs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://ai-architect.tools/cortex
- **Repository:** https://github.com/cdeust/cortex-viz
- **MCP Registry name:** io.github.cdeust/hypermnesia-mcp-viz
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-14

## About

Companion to the Cortex persistent-memory server, this one only reads. It turns the memory store, a live activity stream, Claude Code's session history and a codebase graph into six views: a project galaxy, a 3D anatomical brain, an execution trace, a consolidation board, a knowledge browser and a wiki. The README says it never writes a memory, though it keeps its own derived graph and layout caches in the Cortex database.

You launch it with the `open_visualization` tool or the `/cortex-visualize` command, and the default landing view is Trace, which also works from session transcripts and git without the database. The interface has a paper-style light surface with a night toggle, and every count shown is exact rather than rounded.

It needs Python 3.11 or newer and Cortex installed first, since it reads Cortex's shared PostgreSQL store; the `database_url` setting defaults to `postgresql://127.0.0.1:5432/cortex`. It runs as a stdio server in Claude Code, Codex, Gemini CLI and other hosts.

## Features

- **Six reading views:** Graph, 3D brain, Trace, Knowledge, Wiki and Board.
- **Trace drill-down:** Replays a session's assistant messages and tool calls.
- **Filtering:** Filter by domain, emotion or consolidation stage.
- **Read-only access:** Renders Cortex data without writing memories.
- **Cross-host launch:** Works from Claude Code, Codex, Gemini CLI and other stdio hosts.
- **Light and night themes:** Persistent toggle that re-inks every view.

## Good for

- Browse what Cortex remembers about a project
- Replay a past Claude Code session step by step
- See memories grouped by consolidation stage
- Explore a codebase graph alongside memory

## Install

### Claude Code (Terminal)

```sh
claude mcp add hypermnesia-mcp-viz -- uvx hypermnesia-mcp-viz
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `open_visualization`: Launches the visualizer.
- `get_methodology_graph`: Returns a methodology graph.

## FAQ

### Does it change my memories?

No. The README says it never writes a memory, only its own derived caches.

### What does it need installed?

Python 3.11 or newer, and Cortex pointed at the same PostgreSQL database.

### How do I start it?

Run the open_visualization tool or /cortex-visualize.

### What was it called before?

It was formerly cortex-viz; the README gives migration steps for Claude Code installs.

### Is Hypermnesia MCP Viz free?

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

### How do I add Hypermnesia MCP Viz to Claude Code?

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

### What are the best alternatives to Hypermnesia MCP Viz?

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/hypermnesia-mcp-viz
