# Octobrain

> Octobrain is an open-source MCP server for knowledge and memory. Long-term memory and a knowledge base for AI assistants, run locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Repository:** https://github.com/muvon/octobrain
- **MCP Registry name:** io.github.Muvon/octobrain
- **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

Octobrain is a Rust program that works as a command-line tool and as an MCP server, built to stop assistants starting every conversation from zero. Memories are typed, tagged, scoped to a project (detected from the Git remote) and found by meaning rather than keywords. Related memories link automatically in a Zettelkasten style, and a relationship graph can be explored to a chosen depth.

Beyond single notes it can consolidate a finished goal into a summary, cluster similar recent memories in a sleep-style pass, and fetch memories tied to files or the current Git commit. A separate knowledge base indexes URLs and local text, Markdown, PDF, Word and HTML files for semantic or regex search, and knowledge boxes import Git repositories of documentation.

Embeddings run locally through FastEmbed or HuggingFace by default, so no API key is required. A build without those can use Voyage, OpenAI, Google or Jina instead. The MCP server runs over stdio, or over HTTP with a bind address, and is installable from npm, crates.io, Homebrew or Docker.

## Features

- **Semantic memory search:** Retrieve stored insights by meaning, with graph neighbours returned alongside.
- **Auto-linked memories:** Related entries connect automatically and can be explored as a graph.
- **Knowledge indexing:** Index URLs and local text, Markdown, PDF, Word and HTML files for later search.
- **Memory consolidation:** Fold the memories behind a goal into a summary or cluster similar ones automatically.
- **Knowledge boxes:** Import and sync Git-backed documentation bundles per project or globally.
- **Local embeddings:** FastEmbed and HuggingFace run on your machine; API providers are optional.

## Good for

- Keep architecture decisions available across assistant sessions
- Recall past bug fixes by describing the problem
- Index library docs so an agent can search them offline
- Share a docs repository as a knowledge box across projects
- Surface memories related to the current Git commit

## Install

### Claude Code (Terminal)

```sh
claude mcp add octobrain -- npx -y @muvon/octobrain
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "octobrain": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octobrain"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "octobrain": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octobrain"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "octobrain": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octobrain"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "octobrain": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octobrain"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "octobrain": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octobrain"
      ]
    }
  }
}
```

## Tools

- `memorize`: Store memories with metadata, optionally linked to related ones
- `remember`: Semantic search with filters that returns one-hop graph neighbours
- `forget`: Delete memories after confirmation
- `knowledge`: Unified tool for searching, storing, reading and deleting knowledge content

## FAQ

### Does it need an API key?

Not in the default build, which embeds locally. API embeddings for Voyage, OpenAI, Google or Jina need the matching key.

### How is it installed?

Through npm, cargo install, Homebrew, Docker or packaged mcpb bundles for macOS, Windows and Linux.

### What transports does it use?

The MCP server runs over stdio by default and can bind to an address for HTTP.

### How are memories scoped?

By project, detected from the Git remote, with a flag to override the scope.

### Is Octobrain free?

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

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

Run this command in your terminal: claude mcp add octobrain -- npx -y @muvon/octobrain

### What are the best alternatives to Octobrain?

The closest alternatives to Octobrain 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/octobrain
