# Exomem

> Exomem is an open-source MCP server for knowledge and memory. A Markdown and Obsidian knowledge base that keeps what was true and why it changed. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows, self-hosted, Web
- **Website:** https://substratesystems.io/exomem
- **Repository:** https://github.com/artexis10/exomem
- **MCP Registry name:** io.github.Artexis10/exomem
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

Exomem treats memory as history. When you change your mind, the old note is superseded and kept, so you can ask what you knew in March and why. Notes link by meaning, such as supports or contradicts, and contradictions surface for review instead of one answer silently winning.

It runs as an MCP server over a vault of plain Markdown you own. `uvx exomem demo` runs a bundled sample vault locally, read-only, and walks through doctor, find, get and audit checks in about a second. `exomem setup` wires Claude Code and Codex with the MCP server, ten skills and capture hooks. A hosted version also exists: you subscribe, add it to Claude or ChatGPT, and your vault runs in its own encrypted cell.

If a hosted payment fails, memory turns read-only while Paddle retries, and after cancelling data is kept 30 days.

## Features

- **Superseded notes:** Old notes are kept when replaced.
- **Typed links:** Notes support or contradict each other.
- **Plain Markdown:** Files stay portable and editable outside the server.
- **Demo command:** uvx exomem demo runs a local sample.
- **Hybrid search:** Governed memory with hybrid search.
- **Hosted option:** Per-account encrypted vault with export.

## Good for

- Share one knowledge base across Claude and Codex
- Ask what a decision looked like in a past month
- Review contradictions in project notes
- Try retrieval on a sample vault

## Install

### Claude Code (Terminal)

```sh
claude mcp add exomem -- uvx exomem
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "exomem": {
      "command": "uvx",
      "args": [
        "exomem"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "exomem": {
      "command": "uvx",
      "args": [
        "exomem"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "exomem": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "exomem"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "exomem": {
      "command": "uvx",
      "args": [
        "exomem"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "exomem": {
      "command": "uvx",
      "args": [
        "exomem"
      ]
    }
  }
}
```

## FAQ

### Can I leave the hosted service?

Yes. You can export a verified copy of the vault any time, even after you stop paying.

### What happens if payment fails?

Memory turns read-only while Paddle retries and nothing is lost.

### How do I try it?

Run uvx exomem demo.

### Where is the data stored locally?

In your own Markdown or Obsidian vault.

### Is Exomem free?

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

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

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

### What are the best alternatives to Exomem?

The closest alternatives to Exomem are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [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.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

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