LongBrain Documentation

Give your AI persistent, searchable memory. Connect any MCP-compatible tool in under a minute.

Getting started

Easiest — Plugin Install

For Claude.ai or Claude Desktop:

1
Add marketplace

Settings → Plugins → Add Marketplace → eng-in-law/longbrain-plugins

2
Install plugin

Find longbrain in the list and install it.

3
Sign in

A browser window opens automatically. Sign in with your email — no API keys needed.

For Claude Code (CLI):

/plugin marketplace add eng-in-law/longbrain-plugins
/plugin install longbrain@longbrain

Manual setup

For other tools, visit connect.longbrain.me to get your MCP server URL and token, then follow the guide for your AI tool below.

Connect your AI

Use the server URL and token from your portal. Pick your tool below.

Claude Code / Claude Desktop

Run this in your terminal:

claude mcp add --transport http longbrain <YOUR_MCP_URL> \
  --header "Authorization: Bearer <YOUR_TOKEN>"

Or add to your claude_desktop_config.json:

{
  "mcpServers": {
    "longbrain": {
      "type": "streamable-http",
      "url": "<YOUR_MCP_URL>",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Claude.ai Web

Recommended: Use the plugin install above — no manual config needed.

Manual alternative:

  1. Go to Settings → Integrations → Add more → Custom integration
  2. Paste your MCP URL in the Server URL field
  3. Add a request header — key: Authorization, value: Bearer <YOUR_TOKEN>
  4. Save. Try sending: "Call brain_whoami"

ChatGPT Pro / Team / Enterprise

  1. Settings → Beta features → Developer — enable Developer Mode
  2. In a chat: + → Apps → Add an MCP server
  3. Server URL: paste your MCP URL. Auth type: API key
  4. API key: paste your token (without the "Bearer " prefix)

Codex

codex mcp add longbrain --type streamable-http \
  --url <YOUR_MCP_URL> \
  --header "Authorization: Bearer <YOUR_TOKEN>"

Verify: codex --help-tools should list brain_whoami, brain_remember, brain_recall.

Core concepts

Memories

Each memory is stored with a structured summary: What (the fact), Why (the context), and Thus (the takeaway). Your AI generates these automatically from the content you provide.

Topics

Tag memories with a topic (e.g., preferences, project-notes) to keep them organized. Use topics in brain_recall queries for focused search.

Channels

Brains can send structured messages to each other via brain_channel_send. Messages land in the recipient's inbox and can be listed, read, or acknowledged with brain_channel_inbox.

Tools overview

LongBrain exposes 8 MCP tools. See the full tools reference for parameters and examples.

Best practices