io.github.miisodev/brainllm MCP Server

Name: io.github.miisodev/brainllm MCP Server
Author: io.github.miisodev

io.github.miisodev/brainllm

Repository Registry

What is the io.github.miisodev/brainllm MCP server?

Persistent graph-structured memory for LLMs in TriliumNext Notes — readable and editable by humans.

How to install io.github.miisodev/brainllm

Copy-paste configuration for popular MCP clients.

transport: stdio

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

Environment / auth

TRILIUM_BASE_URL
required
Base URL of the TriliumNext instance, e.g. http://localhost:8080
TRILIUM_ETAPI_TOKEN
secret
ETAPI token. Required unless TRILIUM_PASSWORD is set. Create one in Trilium under Options → ETAPI.
TRILIUM_PASSWORD
secret
Alternative to TRILIUM_ETAPI_TOKEN — BrainLLM mints a token on first start and caches it beside brainllm.json.
BRAINLLM_MODE
core (default) exposes the 39 brain-aware tools; full additionally exposes the 33 raw ETAPI tools.
BRAINLLM_TZ
IANA timezone used to stamp dated notes, e.g. Africa/Johannesburg. Defaults to the host timezone.
BRAINLLM_OWNER_PASSWORD
secret
Enables the OAuth 2.1 / CIMD endpoints required by claude.ai and other hosted Claude surfaces. This is the password entered on the consent screen when authorizing a client.
BRAINLLM_PUBLIC_URL
Override for the public origin when a proxy rewrites Host. Must exactly match the URL entered in the client.

Claude Desktop

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

{
  "mcpServers": {
    "brainllm": {
      "command": "npx",
      "args": [
        "-y",
        "brainllm"
      ],
      "env": {
        "TRILIUM_BASE_URL": "<YOUR_TRILIUM_BASE_URL>",
        "TRILIUM_ETAPI_TOKEN": "<YOUR_TRILIUM_ETAPI_TOKEN>",
        "TRILIUM_PASSWORD": "<YOUR_TRILIUM_PASSWORD>",
        "BRAINLLM_MODE": "<YOUR_BRAINLLM_MODE>",
        "BRAINLLM_TZ": "<YOUR_BRAINLLM_TZ>",
        "BRAINLLM_OWNER_PASSWORD": "<YOUR_BRAINLLM_OWNER_PASSWORD>",
        "BRAINLLM_PUBLIC_URL": "<YOUR_BRAINLLM_PUBLIC_URL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "brainllm": {
      "command": "npx",
      "args": [
        "-y",
        "brainllm"
      ],
      "env": {
        "TRILIUM_BASE_URL": "<YOUR_TRILIUM_BASE_URL>",
        "TRILIUM_ETAPI_TOKEN": "<YOUR_TRILIUM_ETAPI_TOKEN>",
        "TRILIUM_PASSWORD": "<YOUR_TRILIUM_PASSWORD>",
        "BRAINLLM_MODE": "<YOUR_BRAINLLM_MODE>",
        "BRAINLLM_TZ": "<YOUR_BRAINLLM_TZ>",
        "BRAINLLM_OWNER_PASSWORD": "<YOUR_BRAINLLM_OWNER_PASSWORD>",
        "BRAINLLM_PUBLIC_URL": "<YOUR_BRAINLLM_PUBLIC_URL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "brainllm": {
      "command": "npx",
      "args": [
        "-y",
        "brainllm"
      ],
      "env": {
        "TRILIUM_BASE_URL": "<YOUR_TRILIUM_BASE_URL>",
        "TRILIUM_ETAPI_TOKEN": "<YOUR_TRILIUM_ETAPI_TOKEN>",
        "TRILIUM_PASSWORD": "<YOUR_TRILIUM_PASSWORD>",
        "BRAINLLM_MODE": "<YOUR_BRAINLLM_MODE>",
        "BRAINLLM_TZ": "<YOUR_BRAINLLM_TZ>",
        "BRAINLLM_OWNER_PASSWORD": "<YOUR_BRAINLLM_OWNER_PASSWORD>",
        "BRAINLLM_PUBLIC_URL": "<YOUR_BRAINLLM_PUBLIC_URL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "brainllm": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "brainllm"
      ],
      "env": {
        "TRILIUM_BASE_URL": "<YOUR_TRILIUM_BASE_URL>",
        "TRILIUM_ETAPI_TOKEN": "<YOUR_TRILIUM_ETAPI_TOKEN>",
        "TRILIUM_PASSWORD": "<YOUR_TRILIUM_PASSWORD>",
        "BRAINLLM_MODE": "<YOUR_BRAINLLM_MODE>",
        "BRAINLLM_TZ": "<YOUR_BRAINLLM_TZ>",
        "BRAINLLM_OWNER_PASSWORD": "<YOUR_BRAINLLM_OWNER_PASSWORD>",
        "BRAINLLM_PUBLIC_URL": "<YOUR_BRAINLLM_PUBLIC_URL>"
      }
    }
  }
}

Claude Code

claude mcp add brainllm --env TRILIUM_BASE_URL=<YOUR_TRILIUM_BASE_URL> --env TRILIUM_ETAPI_TOKEN=<YOUR_TRILIUM_ETAPI_TOKEN> --env TRILIUM_PASSWORD=<YOUR_TRILIUM_PASSWORD> --env BRAINLLM_MODE=<YOUR_BRAINLLM_MODE> --env BRAINLLM_TZ=<YOUR_BRAINLLM_TZ> --env BRAINLLM_OWNER_PASSWORD=<YOUR_BRAINLLM_OWNER_PASSWORD> --env BRAINLLM_PUBLIC_URL=<YOUR_BRAINLLM_PUBLIC_URL> -- npx -y brainllm