@novaeo/brain-connector

A standalone Model Context Protocol (MCP) connector for the Novaeo Brain — your company's permission-aware memory. It runs as a local stdio MCP server and exposes nine Brain tools to any MCP client (Claude Desktop, Cursor, Codex, or a generic stdio host). Every call is made over HTTPS to the Brain API, authenticated with your personal token. The token is your identity: the server resolves who you are and only ever returns what you are allowed to see.

This package is fully self-contained: no database, no workspace dependencies, and no secrets. Its only runtime dependencies are @modelcontextprotocol/sdk and zod.

Tools

| Tool | What it does | |---|---| | search_brain | Permission-filtered semantic search; returns ranked snippets with citations. | | answer_from_brain | Grounded answer to a question, with source citations. | | write_brain_memory | Write a draft note into the brain under a visibility policy. | | list_action_items | List action items (defaults to your own). | | create_action_item | Create an action item with owner, project, and due date. | | update_action_item | Update an action item's status or fields. | | create_reminder | Create a reminder that inherits its trigger message's visibility. | | summarize_thread | Summarize a chat thread into a short, cited summary. | | promote_to_curated_note | Promote a reviewed note into the curated novaeo-brain vault. |

Configuration

Two environment variables are required. The connector exits with a clear message if either is missing.

| Variable | Required | Description | |---|---|---| | BRAIN_API_URL | yes | Base URL of your Brain API, e.g. https://brain.novaeo.com. | | NOVAEO_BRAIN_TOKEN | yes | Your personal Brain token (starts with nbk_). Sent as Authorization: Bearer <token>. |

Getting your token

Your Brain token is issued from the Connect-your-agent page in the Novaeo app (coming soon). It looks like nbk_.... Treat it like a password — it grants exactly your access. Do not commit it; pass it via your MCP client's environment block.

Usage

Run directly with npx (no install needed):

BRAIN_API_URL=https://brain.novaeo.com \
NOVAEO_BRAIN_TOKEN=nbk_your_token \
npx @novaeo/brain-connector

The process speaks the MCP protocol over stdio; diagnostics go to stderr.

MCP client configuration

Claude Desktop

Edit claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "novaeo-brain": {
      "command": "npx",
      "args": ["-y", "@novaeo/brain-connector"],
      "env": {
        "BRAIN_API_URL": "https://brain.novaeo.com",
        "NOVAEO_BRAIN_TOKEN": "nbk_your_token"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json (or .cursor/mcp.json in your project):

{
  "mcpServers": {
    "novaeo-brain": {
      "command": "npx",
      "args": ["-y", "@novaeo/brain-connector"],
      "env": {
        "BRAIN_API_URL": "https://brain.novaeo.com",
        "NOVAEO_BRAIN_TOKEN": "nbk_your_token"
      }
    }
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.novaeo-brain]
command = "npx"
args = ["-y", "@novaeo/brain-connector"]
env = { BRAIN_API_URL = "https://brain.novaeo.com", NOVAEO_BRAIN_TOKEN = "nbk_your_token" }

Generic stdio MCP client

Any MCP host that launches a command can use:

{
  "command": "npx",
  "args": ["-y", "@novaeo/brain-connector"],
  "env": {
    "BRAIN_API_URL": "https://brain.novaeo.com",
    "NOVAEO_BRAIN_TOKEN": "nbk_your_token"
  }
}

License

MIT