Brain OS MCP Server

Operational memory for AI agents that persists across sessions and tools.

Local serverstdio

What is the Brain OS MCP Server?

Operational memory for AI agents that persists across sessions and tools.

What you get

Local-first MCP memory server for operational project state: decisions, blockers, plans, patterns, and next moves.

AI agents are powerful inside a session, but long-running work has more state than any one chat: what you decided, what's blocked, what's active, and what should not be reopened. Brain OS gives agents operational state, not conversation logs:

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
entity_readRead operational state of one or all tracked entities
entity_updateUpdate entity state — status, momentum, blockers, next moves
decision_logLog a strategic decision with reasoning and alternatives
decision_checkCheck a proposed action against active decisions — returns clear/caution/conflict
decision_refreshRefresh an existing decision: bump review_date, append evidence, change status. Metadata only — does not mutate decision content.
decision_reviewReview-debt inbox: buckets overdue decisions (still-true / changed / archive / needs-evidence) and recommends an action for each. Read-only — proposes, you confirm. Auto-detects duplicate-stub decisions.
context_resolveResolve which entity the current work belongs to, from explicit mention / alias / files / lexical signals. Deterministic and confidence-scored — routes known context, never guesses intent.
focus_getGet prioritized recommendations on what to work on
project_evidence_scanRead-only scan of a repo's native operating state (STATE.md, FLAGS, HANDOFF, ROADMAP/PLAN/TODO, git activity, dirty files) for human gates, next moves, and do-not-touch — grounds focus in repo reality.
pattern_detectAnalyze patterns across all entities
memory_checkAudit memory quality — flags stale data, contradictions, noise
memory_commitEnd-of-session commit — save all state changes
semantic_recallSearch memory by meaning using natural language
audit_logRead the full mutation history — what changed, when, by whom

How to install the Brain OS MCP Server

{
  "mcpServers": {
    "brain-os": {
      "command": "npx",
      "args": ["-y", "brain-os"],
      "env": {
        "BRAIN_EMBEDDINGS": "your-value",
        "OPENAI_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
BRAIN_EMBEDDINGSConfiguration value read at startup.Optional
OPENAI_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • “Use Brain OS to entity read.”
  • “Use Brain OS to entity update.”
  • “Use Brain OS to decision log.”

Frequently asked questions

Operational memory for AI agents that persists across sessions and tools. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.