MCP Server

io.github.spacecowboyian/brains MCP Server

Name: io.github.spacecowboyian/brains MCP Server
Author: io.github.spacecowboyian

io.github.spacecowboyian/brains

Repository Registry

What is the io.github.spacecowboyian/brains MCP server?

Personal wiki and memory for AI assistants: store, search, and recall structured notes.

How to install io.github.spacecowboyian/brains

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

WIKI_DIR
Path to local wiki directory (used when STORAGE_BACKEND=local or omitted)
STORAGE_BACKEND
Storage backend: 'local' (default), 'supabase', or 'drive'
GOOGLE_CLIENT_ID
Google OAuth client ID (required for Google Drive backend)
GOOGLE_CLIENT_SECRET
secret
Google OAuth client secret (required for Google Drive backend)
GOOGLE_REFRESH_TOKEN
secret
Google OAuth refresh token (required for Google Drive backend)
DRIVE_FOLDER_ID
Google Drive folder ID for wiki storage
SUPABASE_URL
Supabase project URL (required for Supabase backend)
SUPABASE_SERVICE_ROLE_KEY
secret
Supabase service role key (required for Supabase backend)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "brains": {
      "command": "npx",
      "args": [
        "-y",
        "brains-mcp"
      ],
      "env": {
        "WIKI_DIR": "<YOUR_WIKI_DIR>",
        "STORAGE_BACKEND": "<YOUR_STORAGE_BACKEND>",
        "GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
        "GOOGLE_REFRESH_TOKEN": "<YOUR_GOOGLE_REFRESH_TOKEN>",
        "DRIVE_FOLDER_ID": "<YOUR_DRIVE_FOLDER_ID>",
        "SUPABASE_URL": "<YOUR_SUPABASE_URL>",
        "SUPABASE_SERVICE_ROLE_KEY": "<YOUR_SUPABASE_SERVICE_ROLE_KEY>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "brains": {
      "command": "npx",
      "args": [
        "-y",
        "brains-mcp"
      ],
      "env": {
        "WIKI_DIR": "<YOUR_WIKI_DIR>",
        "STORAGE_BACKEND": "<YOUR_STORAGE_BACKEND>",
        "GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
        "GOOGLE_REFRESH_TOKEN": "<YOUR_GOOGLE_REFRESH_TOKEN>",
        "DRIVE_FOLDER_ID": "<YOUR_DRIVE_FOLDER_ID>",
        "SUPABASE_URL": "<YOUR_SUPABASE_URL>",
        "SUPABASE_SERVICE_ROLE_KEY": "<YOUR_SUPABASE_SERVICE_ROLE_KEY>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "brains": {
      "command": "npx",
      "args": [
        "-y",
        "brains-mcp"
      ],
      "env": {
        "WIKI_DIR": "<YOUR_WIKI_DIR>",
        "STORAGE_BACKEND": "<YOUR_STORAGE_BACKEND>",
        "GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
        "GOOGLE_REFRESH_TOKEN": "<YOUR_GOOGLE_REFRESH_TOKEN>",
        "DRIVE_FOLDER_ID": "<YOUR_DRIVE_FOLDER_ID>",
        "SUPABASE_URL": "<YOUR_SUPABASE_URL>",
        "SUPABASE_SERVICE_ROLE_KEY": "<YOUR_SUPABASE_SERVICE_ROLE_KEY>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "brains": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "brains-mcp"
      ],
      "env": {
        "WIKI_DIR": "<YOUR_WIKI_DIR>",
        "STORAGE_BACKEND": "<YOUR_STORAGE_BACKEND>",
        "GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
        "GOOGLE_REFRESH_TOKEN": "<YOUR_GOOGLE_REFRESH_TOKEN>",
        "DRIVE_FOLDER_ID": "<YOUR_DRIVE_FOLDER_ID>",
        "SUPABASE_URL": "<YOUR_SUPABASE_URL>",
        "SUPABASE_SERVICE_ROLE_KEY": "<YOUR_SUPABASE_SERVICE_ROLE_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add brains --env WIKI_DIR=<YOUR_WIKI_DIR> --env STORAGE_BACKEND=<YOUR_STORAGE_BACKEND> --env GOOGLE_CLIENT_ID=<YOUR_GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<YOUR_GOOGLE_CLIENT_SECRET> --env GOOGLE_REFRESH_TOKEN=<YOUR_GOOGLE_REFRESH_TOKEN> --env DRIVE_FOLDER_ID=<YOUR_DRIVE_FOLDER_ID> --env SUPABASE_URL=<YOUR_SUPABASE_URL> --env SUPABASE_SERVICE_ROLE_KEY=<YOUR_SUPABASE_SERVICE_ROLE_KEY> -- npx -y brains-mcp