Brains
Personal wiki and memory for AI assistants: store, search, and recall structured notes.
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.101.0
- Listing updated
- 4 days ago
About Brains
Brains is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add brains --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' --env GOOGLE_REFRESH_TOKEN='<GOOGLE_REFRESH_TOKEN>' --env SUPABASE_SERVICE_ROLE_KEY='<SUPABASE_SERVICE_ROLE_KEY>' -- npx -y brains-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"brains": {
"command": "npx",
"args": [
"-y",
"brains-mcp"
],
"env": {
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"GOOGLE_REFRESH_TOKEN": "<GOOGLE_REFRESH_TOKEN>",
"SUPABASE_SERVICE_ROLE_KEY": "<SUPABASE_SERVICE_ROLE_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"brains": {
"command": "npx",
"args": [
"-y",
"brains-mcp"
],
"env": {
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"GOOGLE_REFRESH_TOKEN": "<GOOGLE_REFRESH_TOKEN>",
"SUPABASE_SERVICE_ROLE_KEY": "<SUPABASE_SERVICE_ROLE_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"brains": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"brains-mcp"
],
"env": {
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"GOOGLE_REFRESH_TOKEN": "<GOOGLE_REFRESH_TOKEN>",
"SUPABASE_SERVICE_ROLE_KEY": "<SUPABASE_SERVICE_ROLE_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"brains": {
"command": "npx",
"args": [
"-y",
"brains-mcp"
],
"env": {
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"GOOGLE_REFRESH_TOKEN": "<GOOGLE_REFRESH_TOKEN>",
"SUPABASE_SERVICE_ROLE_KEY": "<SUPABASE_SERVICE_ROLE_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"brains": {
"command": "npx",
"args": [
"-y",
"brains-mcp"
],
"env": {
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"GOOGLE_REFRESH_TOKEN": "<GOOGLE_REFRESH_TOKEN>",
"SUPABASE_SERVICE_ROLE_KEY": "<SUPABASE_SERVICE_ROLE_KEY>"
}
}
}
}Configuration
WIKI_DIRPath to local wiki directory (used when STORAGE_BACKEND=local or omitted)STORAGE_BACKENDStorage backend: 'local' (default), 'supabase', or 'drive'GOOGLE_CLIENT_IDGoogle OAuth client ID (required for Google Drive backend)GOOGLE_CLIENT_SECRETGoogle OAuth client secret (required for Google Drive backend)GOOGLE_REFRESH_TOKENGoogle OAuth refresh token (required for Google Drive backend)DRIVE_FOLDER_IDGoogle Drive folder ID for wiki storageSUPABASE_URLSupabase project URL (required for Supabase backend)SUPABASE_SERVICE_ROLE_KEYSupabase service role key (required for Supabase backend)
Pricing
Open source
Brains FAQ
Is Brains free?
Yes. Brains is open source, so you can use and self-host it for free.
How do I add Brains to Claude Code?
Run this command in your terminal: claude mcp add brains --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' --env GOOGLE_REFRESH_TOKEN='<GOOGLE_REFRESH_TOKEN>' --env SUPABASE_SERVICE_ROLE_KEY='<SUPABASE_SERVICE_ROLE_KEY>' -- npx -y brains-mcp
What are the best alternatives to Brains?
The closest alternatives to Brains are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.
Alternatives to Brains

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
MedXpert 图书馆连接器(通用版)
MCP serverLocal MCP server that searches and answers questions over your own Markdown wiki
Runs locally- 4 tools
- Open source
- Knowledge and memory