Octobrain
Long-term memory and a knowledge base for AI assistants, run locally
- 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/octobrainAdd to claude_desktop_config.json
{
"mcpServers": {
"octobrain": {
"command": "npx",
"args": [
"-y",
"@muvon/octobrain"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"octobrain": {
"command": "npx",
"args": [
"-y",
"@muvon/octobrain"
]
}
}
}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.


