English Français العربية

io.github.spacecowboyian/brains

Official registry Search and web

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

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package brains-mcp
Claude Code 
claude mcp add brains -e 'WIKI_DIR=<WIKI_DIR>' -e 'STORAGE_BACKEND=<STORAGE_BACKEND>' -e 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' -e 'GOOGLE_CLIENT_SECRET=<your google_client_secret>' -e 'GOOGLE_REFRESH_TOKEN=<your google_refresh_token>' -e 'DRIVE_FOLDER_ID=<DRIVE_FOLDER_ID>' -e 'SUPABASE_URL=<SUPABASE_URL>' -e 'SUPABASE_SERVICE_ROLE_KEY=<your supabase_service_role_key>' -- npx -y brains-mcp@1.101.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "brains": {
            "command": "npx",
            "args": [
                "-y",
                "brains-mcp@1.101.0"
            ],
            "env": {
                "WIKI_DIR": "<WIKI_DIR>",
                "STORAGE_BACKEND": "<STORAGE_BACKEND>",
                "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
                "GOOGLE_CLIENT_SECRET": "<your google_client_secret>",
                "GOOGLE_REFRESH_TOKEN": "<your google_refresh_token>",
                "DRIVE_FOLDER_ID": "<DRIVE_FOLDER_ID>",
                "SUPABASE_URL": "<SUPABASE_URL>",
                "SUPABASE_SERVICE_ROLE_KEY": "<your supabase_service_role_key>"
            }
        }
    }
}

Environment variables

  • 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)

Frequently asked questions

What is io.github.spacecowboyian/brains?

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

How do I install io.github.spacecowboyian/brains?

It runs on your machine. In Claude Code: claude mcp add brains -e 'WIKI_DIR=<WIKI_DIR>' -e 'STORAGE_BACKEND=<STORAGE_BACKEND>' -e 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' -e 'GOOGLE_CLIENT_SECRET=<your google_client_secret>' -e 'GOOGLE_REFRESH_TOKEN=<your google_refresh_token>' -e 'DRIVE_FOLDER_ID=<DRIVE_FOLDER_ID>' -e 'SUPABASE_URL=<SUPABASE_URL>' -e 'SUPABASE_SERVICE_ROLE_KEY=<your supabase_service_role_key>' -- npx -y brains-mcp@1.101.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.spacecowboyian/brains need an API key?

Yes. It expects GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN, SUPABASE_SERVICE_ROLE_KEY, which you set in its configuration.

Is io.github.spacecowboyian/brains open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.spacecowboyian/brains?

It is published by spacecowboyian. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.