Skip to content
Download

Connectors

Open Brain

Give an Odd your Open Brain, and it can search everything you have saved there. Let it, and it saves new thoughts too. It takes about two minutes.

What Open Brain is

Open Brain is a memory you own. It is a database of your thoughts, notes and ideas that any AI tool can search and add to, so they all remember the same things about you. You run it yourself, on your own Supabase project. Nate B. Jones made it, and it lives on GitHub.

Open Brain on GitHub

Before you start

  1. Build your Open Brain with its setup guide. Come back when it says you are done.
  2. Open your credential tracker from that guide. You need two things from it:
    • MCP Server URL, the address of your brain.
    • MCP Access Key, the key that lets you in.
  3. Open Oddboro, with the Odd you want to give it to already hired.

Part 1. Add Open Brain to an Odd

  1. Click the Odd on the strip of Odds at the edge of the screen.

    Its panel opens.

  2. Click Settings.

  3. Click Services.

  4. Click + Add service.

  5. Paste your MCP Server URL into the search box.

    Use the address that ends in /open-brain-mcp, with no ?key= after it. The key goes in later, somewhere safer.

    https://YOUR_PROJECT_REF.supabase.co/functions/v1/open-brain-mcp

  6. Click Connect YOUR_PROJECT_REF.supabase.co, just under the box.

  7. Click Takes a key.

  8. In “The header the key goes in”, delete Authorization and type x-brain-key.

    All lowercase, with the dashes.

    x-brain-key

  9. Pick how far the Odd can go.

    Read only lets it search your thoughts. Read and write also lets it save new ones. Read and write is greyed out until the Odd’s Permission level, on the Model tab, is Acts on its own.

  10. Click Grant.

    You see: “A task with the steps to connect … is on your desk.”

Part 2. Connect it from your desk

  1. Click Desk.

  2. Open the task named Connect YOUR_PROJECT_REF.supabase.co for your Odd.

  3. Paste your MCP Access Key into the box.

    It is the 64-character key from your credential tracker. It goes in this computer’s password store, never the office’s database.

  4. Click Save.

  5. Click Connect.

    The office reaches your Open Brain and lists its tools.

  6. Leave the ticks as they are, and click Confirm.

    The ticked tools only read. capture_thought, the one that saves, stays unticked, so only a Read and write Odd can use it.

Try it

Open a chat with the Odd and ask, “What have I saved about this week?” It searches your Open Brain and answers from it.

If something goes wrong

Connect fails, or says 401.
The header or the key is off. The header must be x-brain-key, exactly. The key must match your MCP Access Key, with no space before or after it. Click Revoke on the service and start again.
I pasted the address with ?key= on the end.
Click Revoke on the service, then add it again with the address that ends in /open-brain-mcp. That keeps your key in the password store instead of in the address.
Read and write is greyed out.
On the Odd’s Model tab, set Permission level to Acts on its own first. Read only works at any level.
I want a second Odd to use it too.
On that Odd, click Settings, then Services, then + Add service. Pick YOUR_PROJECT_REF.supabase.co from the list, where it shows “in the office”. Pick a level and click Grant. The office already has the key, so there is nothing to paste and nothing on your desk.

For problems with Open Brain itself, see its setup guide.