Open Brain Template

v1.0.0Knowledge & Memorystable

Persistent memory + smart query for AI agents. Visual dashboard, semantic search, Memory Steward (Anthropic Managed Agent), SessionStart auto-load hook. One brain across Claude Code / Desktop / Cursor / ChatGPT. Built on Supabase + Vercel + Mem0.

ai-agentai-memoryanthropic-managed-agentsbrain-mapclaude
Share:
23
Stars
0
Downloads
0
Weekly
0/5

What is Open Brain Template?

Open Brain Template is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to persistent memory + smart query for ai agents. visual dashboard, semantic search, memory steward (anthropic managed agent), sessionstart auto-load hook. one brain across claude code / desktop / cursor...

Persistent memory + smart query for AI agents. Visual dashboard, semantic search, Memory Steward (Anthropic Managed Agent), SessionStart auto-load hook. One brain across Claude Code / Desktop / Cursor / ChatGPT. Built on Supabase + Vercel + Mem0.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Persistent memory + smart query for AI agents. Visual dashbo

Use Cases

Persistent AI agent memory
Semantic search dashboard
Multi-platform brain sync
wefilmshit

Maintainer

LicenseMIT
Languagehtml
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx open-brain-template

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Open Brain Template

Open Brain Template is an open-source persistent memory system for AI agents, built on Supabase (PostgreSQL + pgvector), Vercel, and optionally Mem0, that gives Claude Code, Claude Desktop, Cursor, and ChatGPT a shared long-term memory store across all sessions. It exposes six MCP tools — `remember`, `recall`, `memory_query`, `recent_memories`, `forget`, and `memory_stats` — and ships with a visual dashboard for browsing and managing stored memories. The optional SessionStart hook auto-injects the most recent memories at the start of every Claude session, ensuring continuity without manual prompting.

Prerequisites

  • A Supabase account with a new project created (free tier works) — for the PostgreSQL + pgvector backend
  • A Vercel account for hosting the dashboard frontend
  • Google OAuth configured in Supabase Auth (the dashboard uses Google sign-in)
  • Node.js and git for local development
  • An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
1

Create a Supabase project

Go to supabase.com and create a new project. Note your project URL and anon key from the project settings — you will need them in the next step.

2

Clone the repository

Clone the Open Brain Template repository to your local machine.

git clone https://github.com/wefilmshit/open-brain-template.git
cd open-brain-template
3

Configure Supabase credentials in index.html

Open `index.html` and replace the placeholder values with your Supabase project URL and anon key. Also add your email address to the `ALLOWED_EMAILS` array to restrict dashboard access.

# In index.html, update these values:
# YOUR_SUPABASE_URL  → your project URL (e.g. https://xyz.supabase.co)
# YOUR_SUPABASE_ANON_KEY → your project anon key
# ALLOWED_EMAILS → ['[email protected]']
4

Deploy the dashboard to Vercel

Deploy the repository to Vercel using the Vercel CLI or by importing the repository via the Vercel web interface. The dashboard will be available at your Vercel deployment URL.

npx vercel deploy
5

Configure the MCP server in your client

Add the Open Brain MCP server to your MCP client configuration. The server connects to Supabase using your project URL and anon key as environment variables.

{
  "mcpServers": {
    "open-brain": {
      "command": "npx",
      "args": ["open-brain-template"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_ANON_KEY": "your-anon-key"
      }
    }
  }
}
6

Optional: Enable the SessionStart hook

To auto-load recent memories at the start of every Claude session, configure the SessionStart hook in `~/.claude/settings.json`. This calls the `recent_memories` tool automatically when a new session begins.

# In ~/.claude/settings.json, add the SessionStart hook
# per the instructions in the repo's CLAUDE.md file

Open Brain Template Examples

Client configuration

Claude Desktop configuration for Open Brain Template with Supabase credentials.

{
  "mcpServers": {
    "open-brain": {
      "command": "npx",
      "args": ["open-brain-template"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_ANON_KEY": "your-supabase-anon-key"
      }
    }
  }
}

Prompts to try

Example prompts that use the six memory tools to store, retrieve, and manage persistent knowledge.

- "Remember that we decided to use PostgreSQL for the user service because of its JSONB support"
- "What do you remember about the authentication module from our previous sessions?"
- "Query my memories for anything related to the API rate limiting discussion"
- "Show me the 10 most recent memories you've stored"
- "How many memories are stored in my brain and what categories are most common?"
- "Forget the memory about using Redis for session storage — we changed that decision"

Troubleshooting Open Brain Template

Dashboard shows a blank page or authentication error after Vercel deployment

Ensure your email address is in the `ALLOWED_EMAILS` array in `index.html` before deploying. Also verify that Google OAuth is enabled in your Supabase Auth settings under Authentication > Providers.

recall or memory_query returns no results even after storing memories

pgvector must be enabled in your Supabase project. Go to Database > Extensions in the Supabase dashboard and enable the `vector` extension. Then re-run any database migrations referenced in the repo.

MCP server fails to start with SUPABASE_URL not set error

Ensure both `SUPABASE_URL` and `SUPABASE_ANON_KEY` are set in the `env` block of your MCP client configuration. These are required for every connection — the server has no fallback values.

Frequently Asked Questions about Open Brain Template

What is Open Brain Template?

Open Brain Template is a Model Context Protocol (MCP) server that persistent memory + smart query for ai agents. visual dashboard, semantic search, memory steward (anthropic managed agent), sessionstart auto-load hook. one brain across claude code / desktop / cursor / chatgpt. built on supabase + vercel + mem0. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Open Brain Template?

Follow the installation instructions on the Open Brain Template GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Open Brain Template?

Open Brain Template works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Open Brain Template free to use?

Yes, Open Brain Template is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "open-brain-template": { "command": "npx", "args": ["-y", "open-brain-template"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Open Brain Template?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides