# RootMind

> RootMind is an open-source MCP server for knowledge and memory. Search your local documents with page, slide and sheet citations. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, Linux, self-hosted
- **Repository:** https://github.com/cgaeking/rootmind
- **MCP Registry name:** io.github.cgaeking/rootmind
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

There is no embedding model or vector database behind RootMind. Indexing is plain full-text search in SQLite, and the language model drives retrieval by searching and reading targeted windows, with every step shown as a tool call. The README admits this costs more model round trips than classic RAG.

The desktop app, for Windows and Linux in English and German, indexes folders you choose (PDF, Word, Excel, PowerPoint, CSV, Markdown and text). Indexing and search are local and need no API key. Answering sends the question and the passages read to Anthropic, OpenAI or xAI, or stays on your machine with Ollama.

The MCP server offers the same read-only search tools. Claude Desktop installs a `rootmind.mcpb` bundle by double-click, while Claude on the web or phone uses a remote connector through ngrok. The registry entry needs the RootMind app installed, and the code is MIT licensed.

## Features

- **Cited answers:** Answers name files and the page, slide or sheet where possible.
- **Local indexing:** Full-text search in SQLite, no embedding model.
- **Many file types:** PDF, Word, Excel, PowerPoint, CSV, Markdown and text.
- **Search-only mode:** Search without an API key.
- **Provider choice:** Anthropic, OpenAI, xAI or local Ollama.
- **MCP access:** Read-only tools for Claude Desktop, Claude Code and n8n.

## Good for

- Ask a question across a folder of contracts and cite the page
- Search spreadsheets and slides together
- Keep documents on your computer with a local model
- Use your files from Claude Desktop

## Install

### Claude Code (Terminal)

```sh
claude mcp add rootmind -- npx -y https://github.com/cgaeking/rootmind/releases/download/v2.10.1/rootmind.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rootmind": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cgaeking/rootmind/releases/download/v2.10.1/rootmind.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rootmind": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cgaeking/rootmind/releases/download/v2.10.1/rootmind.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "rootmind": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cgaeking/rootmind/releases/download/v2.10.1/rootmind.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rootmind": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cgaeking/rootmind/releases/download/v2.10.1/rootmind.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rootmind": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cgaeking/rootmind/releases/download/v2.10.1/rootmind.mcpb"
      ]
    }
  }
}
```

## FAQ

### Do my files leave my computer?

Indexing is local; answering sends the question and read excerpts to your chosen provider, unless you use Ollama.

### Do I need an API key?

Not for search-only or for MCP use with your own model.

### Which systems?

Windows 10 or 11 and Linux.

### Licence?

MIT.

### Is RootMind free?

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

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

Run this command in your terminal: claude mcp add rootmind -- npx -y https://github.com/cgaeking/rootmind/releases/download/v2.10.1/rootmind.mcpb

### What are the best alternatives to RootMind?

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

## Where this comes from

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

## 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.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [Digitalnz](https://ai-powered.com/mcp/digitalnz): Digitalnz is a freemium MCP server for knowledge and memory.

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