# Memdex

> Memdex is an MCP server for knowledge and memory. One SQLite memory file that coding agents share, with summaries, notes and messages. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/choyugyeong/memdex
- **MCP Registry name:** io.github.ChoYugyeong/memdex
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Memdex gives several agents one memory store so a new session starts from what the last left. File summaries are keyed to a content hash rather than a path, so a summary stays valid until the file changes and the agent is told when it goes stale. Notes such as decisions and pitfalls cite the files they depend on and are flagged when those files change.

Coordination features include `claim` for files being edited, `post` and `inbox` for agent-to-agent messages, and `handoff` for the next session. Worktrees of one repository share the same memory. The README reports that on a 66-file repo, outlines took 3,471 tokens against 154,105 for reading every file, using a rough chars-divided-by-four estimate.

Setup is `memdex connect`, which merges config into installed clients and backs up first, with `--serve-check` verifying initialize and tools/list. Each agent gets a self-declared name via MEMDEX_AGENT. Data is a SQLite file under `~/.memdex`.

## Features

- **Hash-keyed summaries:** File summaries stay valid until content changes and warn when stale.
- **Notes that expire:** Decisions and pitfalls are flagged when the files they cite change.
- **Agent messaging:** Post, inbox, claim and handoff let agents coordinate on one repo.
- **One-command connect:** memdex connect wires many clients and can verify the server answers.
- **Token benchmark:** memdex bench estimates read cost against outlines in your checkout.

## Good for

- Resume work in a new session without re-reading large files
- Stop two agents editing the same file
- Leave a handoff for the next agent
- Share lessons between Claude Code, Codex and Cursor

## Install

### Claude Code (Terminal)

```sh
claude mcp add memdex -- uvx memdex-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `file_summary`: Read a stored summary for a file before reading it
- `project_brief`: Show what the last session left for you
- `remember`: Save a note or decision

## FAQ

### Where is data stored?

In a SQLite file, by default memdex.db under ~/.memdex.

### Does it need a cloud?

No. The README says one SQLite file, zero dependencies and no cloud.

### Which clients does connect support?

Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed, Cline, Gemini CLI, Codex CLI and DeepSeek Harness.

### Is the agent name verified?

No. MEMDEX_AGENT is a self-declared label, not an authenticated identity.

### How do I add Memdex to Claude Code?

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

### What are the best alternatives to Memdex?

The closest alternatives to Memdex are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

---
Source: https://ai-powered.com/mcp/memdex
