# Ariadne

> Ariadne is an open-source MCP server for knowledge and memory. Local-first multilingual memory for coding agents, with verified backups and isolation. It runs locally on your machine and is started by your AI client.

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

## About

Ariadne replaces memory backends that crash or starve when several agent sessions write at once. Instead of an embedded database, it keeps memories in a Qdrant server bound to 127.0.0.1, with Ollama serving the bge-m3 model locally. Dense multilingual meaning and exact BM25 terms are fused for retrieval, so the site says an English query can find Ukrainian notes.

Projects are isolated by default. A search across another project opens a scoped approval request that a person must decide in the tray menu, so an agent cannot quietly read another project. Recent releases focus on backups: a failed backup stays a warning until a successful one completes, a new full set must pass independent file, database and model recovery checks before it replaces the kept one, and an explicit repair mode keeps earlier copies.

It is written in Go and runs without Docker, a cloud account or API keys. Windows has a native x64 installer, and a shell installer is provided for Mac and Linux. Memory can be exported as portable JSONL or saved as full Qdrant snapshots.

## Features

- **Concurrent sessions:** Qdrant serves several agents at once without file-lock starvation.
- **Multilingual recall:** bge-m3 embeddings plus BM25 across 100+ languages.
- **Project isolation:** Cross-project recall needs a visible human approval.
- **Verified backup rotation:** New backup sets pass recovery checks before replacing the old one.
- **Visible failures:** Failed backups stay flagged and notify again on each new failure.
- **Portable export:** JSONL export or full Qdrant snapshots for moving memories.

## Good for

- Give Codex and Claude Code a shared memory across sessions
- Recall notes written in another language
- Keep one project's memory out of another's searches
- Back up agent memory with tested recovery
- Run agent memory fully offline

## Install

### Claude Code (Terminal)

```sh
claude mcp add ariadne -- npx -y https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ariadne": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ariadne": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "ariadne": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ariadne": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ariadne": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
      ]
    }
  }
}
```

## FAQ

### Does it send memory to the cloud?

No. The default stack uses local Qdrant and local Ollama endpoints.

### Can several sessions use it at once?

Yes, Qdrant is a server and handles concurrent access natively.

### Can an agent search another project silently?

No. Cross-project recall opens a scoped approval request first.

### Can I move my memories later?

Yes, by exporting portable JSONL or taking full Qdrant snapshots.

### Is Ariadne free?

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

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

Run this command in your terminal: claude mcp add ariadne -- npx -y https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb

### What are the best alternatives to Ariadne?

The closest alternatives to Ariadne 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/ariadne-2
