Open Brain Server MCP Server

A self-hostable memory server for MCP clients (Claude, ChatGPT, any assistant that speaks MCP). Thoughts flow in from Telegram, pipelines, or direct

Remote serverstreamable-httpPython

What is the Open Brain Server MCP server?

Open Brain Server MCP server exists for a simple reason — assistants are far more useful when they can act on Open Brain Server directly instead of describing what you should do. A self-hostable memory server for MCP clients (Claude, ChatGPT, any assistant that speaks MCP). Thoughts flow in from Telegram, pipelines, or direct capture, and land in a Newman-IDF weighted entity graph — not a flat document store. An.

What the assistant can call

Once Open Brain Server is connected, these are the calls the assistant has available:

  • search_thoughts — Semantic search with optional graph expansion (1-hop traversal)
  • list_thoughts — Browse thoughts filtered by type, topic, person, theme, quality, time
  • thought_stats — Aggregate statistics: counts, type/theme breakdown, top topics/people
  • capture_thought — Save a new thought from any AI client (with auto-embedding)
  • get_connections — Graph traversal from a thought (typed links: extends, contradicts, etc.)
  • list_entities — Browse extracted entities (people, tools, projects, orgs) by frequency
  • weekly_review — AI-generated summary of themes, open loops, and next steps
  • analyze — Graph analysis: hubs, density, sources, co-occurrence, themes
  • dedup_review — Duplicate candidates with similarity zone histogram
  • refresh_salience — Recompute all salience scores
  • update_thought — Rewrite content (re-embeds, re-extracts metadata)
  • delete_thought — Permanent delete (cascades connections)

Setting it up

Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.

Configuration and credentials

You will need 3 environment variables: YOUR_BOT_TOKEN, YOUR_MCP_KEY, MCP_ACCESS_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  1. Supabase account -- Supabase is a hosted Postgres database with built-in APIs, authentication, and Edge Functions (serverless code). Create a free account at supabase.com. Create a new project -- you will need the project URL (looks like https://abcdef.supabase.co) and the service role key (a long string found under Settings > API). 2. Supabase CLI --

Choosing this one

Plenty of database access servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Open Brain Server's toolset — search_thoughts, list_thoughts, thought_stats and 11 more — is a fair guide to whether it matches your workflow. It is maintained by bobby-cell-commits; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Before you rely on it

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Open Brain Server.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the open brain server mcp server does with a few real requests.

Available tools

ToolWhat it does
search_thoughtsSemantic search with optional graph expansion (1-hop traversal)
list_thoughtsBrowse thoughts filtered by type, topic, person, theme, quality, time
thought_statsAggregate statistics: counts, type/theme breakdown, top topics/people
capture_thoughtSave a new thought from any AI client (with auto-embedding)
get_connectionsGraph traversal from a thought (typed links: extends, contradicts, etc.)
list_entitiesBrowse extracted entities (people, tools, projects, orgs) by frequency
weekly_reviewAI-generated summary of themes, open loops, and next steps
analyzeGraph analysis: hubs, density, sources, co-occurrence, themes
dedup_reviewDuplicate candidates with similarity zone histogram
refresh_salienceRecompute all salience scores
update_thoughtRewrite content (re-embeds, re-extracts metadata)
delete_thoughtPermanent delete (cascades connections)
serendipity_digestResurface forgotten high-quality thoughts
pipelinePipeline monitoring: health status, run history, merge audit

How to install the Open Brain Server MCP server

{
  "mcpServers": {
    "open-brain-server": {
      "command": "npx",
      "args": ["-y", "supabase"],
      "env": {
        "YOUR_BOT_TOKEN": "your-value",
        "YOUR_MCP_KEY": "your-value",
        "MCP_ACCESS_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  1. Supabase account -- Supabase is a hosted Postgres database with built-in APIs, authentication, and Edge Functions (serverless code). Create a free account at supabase.com. Create a new project -- you will need the project URL (looks like https://abcdef.supabase.co) and the service role key (a long string found under Settings > API). 2. Supabase CLI --
VariableDescriptionRequired
YOUR_BOT_TOKENCredential the server authenticates with.Yes
YOUR_MCP_KEYCredential the server authenticates with.Yes
MCP_ACCESS_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Open Brain Server to search thoughts.
  • Use Open Brain Server to list thoughts.
  • Use Open Brain Server to thought stats.

Frequently asked questions

It connects Open Brain Server to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (search_thoughts, list_thoughts, thought_stats, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Open Brain Server directly.