# Open Brain

This MCP server stores thoughts as a graph in Postgres and retrieves them by meaning. Use it when an assistant needs memory across sessions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: Bobby-cell-commits
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Bobby-cell-commits/open-brain-server
- Updated: 2026-04-17
- HTML: https://affpapa.org/en/nevibecode/mcp/open-brain

## What it does

Open Brain accepts thoughts from an MCP client, a Telegram bot, or a feed pipeline covering RSS and research papers. It stores embeddings, topics, people, projects, and links in Postgres with pgvector. An assistant can search by meaning, filters, or time, then request a weekly theme review.

The server detects semantic duplicates, connects related thoughts, and assigns relationship types to linked records. A background Dream cycle combines findings from clusters and archives stale material. You can deploy it through Supabase or Docker Compose; the Supabase route uses `./scripts/bootstrap.sh`, `./scripts/deploy.sh`, and `./scripts/validate.sh`.

OpenRouter is required for embeddings and metadata extraction, while the Supabase route also needs a Supabase project and the Supabase CLI. Without the OpenRouter key, vector creation and metadata extraction will fail.

## Requirements
- Remote server: `https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http open-brain https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add open-brain --url https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "open-brain": {
            "url": "https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "open-brain": {
            "type": "http",
            "url": "https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http open-brain https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcp
```

## When to use it
- capture thoughts from Telegram and an MCP client
- search stored notes by meaning
- remove semantically duplicated thoughts
- generate a weekly review of themes
- connect people, projects, and tools in a graph

## Example prompts
- Search memory for database migration notes and group the results by theme.
- Find related records about the `open_brain` project for a given period.
- Create a weekly theme review and flag thoughts that contradict each other.

## Similar
- [myco-brain](https://affpapa.org/en/nevibecode/mcp/myco-brain.md) — MCP server · ★ 7
- [Memory Vault](https://affpapa.org/en/nevibecode/mcp/memory-vault.md) — MCP server · ★ 65
- [hypermnesia-mcp](https://affpapa.org/en/nevibecode/mcp/hypermnesia-mcp.md) — MCP server · ★ 75
- [memory-industry](https://affpapa.org/en/nevibecode/mcp/memory-industry.md) — MCP server · ★ 30
- [Epitome](https://affpapa.org/en/nevibecode/mcp/epitome.md) — MCP server · ★ 8
- [strata](https://affpapa.org/en/nevibecode/mcp/agenerationforwordz-tech-strata.md) — MCP server · ★ 6

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md