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:
- Go to Settings → Integrations → Add more → Custom integration
- Paste your MCP URL in the Server URL field
- Add a request header — key:
Authorization, value: Bearer <YOUR_TOKEN>
- Save. Try sending: "Call brain_whoami"
ChatGPT Pro / Team / Enterprise
- Settings → Beta features → Developer — enable Developer Mode
- In a chat: + → Apps → Add an MCP server
- Server URL: paste your MCP URL. Auth type: API key
- 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.