Skip to content
MCP server

Octobrain

Long-term memory and a knowledge base for AI assistants, run locally

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.15.2
Listing updated
today

Similar MCP servers

About Octobrain

Octobrain is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "octobrain": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octobrain"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "octobrain": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octobrain"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Octobrain 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.

How AIPoweredBot checks servers