@open-brain-ai/mcp

A Model Context Protocol (MCP) server that exposes your Open Brain — memories, wiki entities and facts, daily journal entries, and action items — as queryable tools to any MCP-compatible AI client (Claude Desktop, Claude Code, Cursor, etc.).

Built on the Selway Solutions Plaud → Supabase substrate.

What you can ask

Once installed, you can ask Claude (in any MCP-compatible client) questions like:

• "What did John say last week about Project Phoenix?"
• "Summarize my interactions with Sarah this month"
• "What action items did I have on May 13?"
• "Read me my daily journal from yesterday"
• "What do I know about Carolyn?"
• "Find the conversation where I mentioned the Robinson Canyon trail"

Claude routes these through the MCP server's tools, which query your private Supabase database, and returns memory-grounded answers.

V0.5 tool surface

| Tool | What it does | Status | |---|---|---| | search_memories | Full-text search over memory transcripts | ✅ Shipped | | search_entities | Find people, places, projects by name (fuzzy match) | Coming | | get_entity_details | Return one entity with all facts and relationships | Coming | | list_recent_memories | Last N hours of memories with timestamps | Coming | | list_pending_action_items | Action items in your inbox (extracted, not yet dispatched from app) | Coming |

get_daily_diary is deferred to V0.6 — the daily-diary feature writes to your Google Doc, not Supabase, so this tool requires OAuth token handling that's a separate sprint.

Install

npm install -g @open-brain-ai/mcp

Or use without installing globally via npx @open-brain-ai/mcp.

Configuration

The MCP server reads three environment variables:

| Variable | What | |---|---| | SUPABASE_URL | Your careib Supabase project URL (default: https://nojvsdnhbeawedrozybl.supabase.co) | | SUPABASE_ANON_KEY | Your careib publishable key (starts with sb_publishable_). Found in Supabase dashboard → Project Settings → API → Project API keys → anon. | | PRIMARY_SUBSCRIBER_ID | Your subscriber UUID in micoco.subscribers. V0.5 single-user shortcut. |

Copy .env.example to .env and fill in your values, OR set them in the Claude Desktop MCP config (see below).

Claude Desktop setup

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (on macOS) and add:

{
  "mcpServers": {
    "open-brain": {
      "command": "npx",
      "args": ["-y", "@open-brain-ai/mcp"],
      "env": {
        "SUPABASE_URL": "https://nojvsdnhbeawedrozybl.supabase.co",
        "SUPABASE_ANON_KEY": "sb_publishable_...",
        "PRIMARY_SUBSCRIBER_ID": "your-uuid-here"
      }
    }
  }
}

Restart Claude Desktop. The Open Brain tools should appear in the MCP sidebar.

Claude Code setup

claude mcp add open-brain \
  --command "npx" \
  --args "-y,@open-brain-ai/mcp" \
  --env "SUPABASE_URL=https://nojvsdnhbeawedrozybl.supabase.co" \
  --env "SUPABASE_ANON_KEY=sb_publishable_..." \
  --env "PRIMARY_SUBSCRIBER_ID=your-uuid-here"

Security model

The sb_publishable_... key is, per Supabase's design, a public key. It's safe to ship in client configurations. Per-row access is enforced by Row-Level Security (RLS) policies on the server, not by the key itself.

The MCP server is read-only by design. Writes to your Open Brain happen via:

• The Plaud → Action Pings → Edge Function pipeline (action items)
• The daily-diary Edge Function (journal entries)
• The wiki-extractor Edge Function (entities, facts, relationships)
• The MiCoco iOS app (dispatch tracking)

The MCP server queries this data; it never modifies it.

Roadmap

• V0.5 (in progress): 5 read tools, anon + RLS auth, stdio transport, npm-published, local installation.
• V0.6: 3 more read tools (action items inbox, fact search, action item history).
• V1: HTTP/SSE transport hosted at mcp.open-brain.io/mcp for mobile + remote clients.
• V2: Per-user routing — the MCP automatically queries each user's own Supabase instance via the open-brain.io provisioner.

Development

git clone [email protected]:nickima2026/open-brain-mcp.git
cd open-brain-mcp
npm install
cp .env.example .env  # fill in your values
npm run dev           # tsx watch mode

Test in Claude Desktop by pointing the config at the local dist:

{
  "mcpServers": {
    "open-brain-dev": {
      "command": "node",
      "args": ["/Users/yourname/Documents/Claude/Projects/open-brain-mcp/dist/index.js"]
    }
  }
}

License

MIT © 2026 Selway Solutions LLC