Memex

Memex MCP provides a standardized HTTP interface to access and manage your Claude Code session history. It lets you search, retrieve sessions, list projects, and browse recent activity remotely, enabling seamless integration with your tools and workflows without losing historical context.

How to use

Connect your MCP client to Memex at http://127.0.0.1:10013/api/mcp. Use the provided MCP endpoints to search and fetch Claude Code session history, inspect individual sessions, and browse projects.

How to install

Prerequisites: ensure you have Node.js version 18 or newer and a compatible package manager installed on your system.

Option A: Quick start with Docker (no Node.js or build tools required) run this command to start Memex and its web UI.

# One command to start
docker run -d \
  --name memex \
  -p 3000:3000 \
  -v ~/.claude/projects:/claude-sessions:ro \
  -v memex-data:/data \
  ghcr.io/vimo-ai/memex:latest

# Or use docker-compose
curl -sL https://raw.githubusercontent.com/vimo-ai/memex/main/docker-compose.yml -o docker-compose.yml
docker-compose up -d

Option B: Install from source

Clone the project, install dependencies, and run the services in development or production modes.

Prerequisites for source install include a code editor, Git, and a terminal.

# Clone project
git clone <repository-url>
cd memex

# Install dependencies
pnpm install

# Web UI dependencies
cd web
pnpm install
cd ..

Available tools

search_history

MCP endpoint to search historical Claude Code conversations across projects and sessions.

get_session

MCP endpoint to retrieve a specific session, including its content and metadata.

get_recent_sessions

MCP endpoint to fetch a list of recently accessed sessions.

list_projects

MCP endpoint to list all Claude Code projects with their sessions.