Open Brain — Claude Code MCP server: what it does, how to install
This MCP server stores thoughts as a graph in Postgres and retrieves them by meaning. Use it when an assistant needs memory across sessions.
Open on GitHubWhat Open Brain 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.
What it helps with
- 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 for the agent
- Search memory for database migration notes and group the results by theme.
- Find related records about the
open_brainproject for a given period. - Create a weekly theme review and flag thoughts that contradict each other.
How to install Open Brain
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http open-brain https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add open-brain --url https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"open-brain": {
"url": "https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"open-brain": {
"type": "http",
"url": "https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http open-brain https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Open Brain
How do I install Open Brain in Claude Code?
After deploying the server, add the MCP connection with claude mcp add --transport http open-brain https://{supabase_project_ref}.supabase.co/functions/v1/open-brain-mcp/mcp.
What does Open Brain do?
It stores thoughts in a Postgres graph with pgvector, retrieves them by meaning, and links records through shared entities. It also removes duplicates and prepares theme reviews.
What does Open Brain require?
The Supabase setup needs a Supabase account and project, the Supabase CLI, and an OpenRouter API key. A Telegram bot is an extra setup step for capturing thoughts through Telegram.
