Thebrain MCP Server
by ybookoffio.github.yBookoff/thebrainv0.1.5
MCP server for TheBrain 15: search by meaning, graph traversal and batch writes over the local API
context tax
queued
security
queued
cold start
queued
freshness
Active10d ago
Install Thebrain MCP server
Install in Claude Code
claude mcp add thebrain-ybookoff -e THEBRAIN_API_KEY='<thebrain-api-key>' -- npx -y thebrain-mcp-serverInstall in Cursor
{
"mcpServers": {
"thebrain-ybookoff": {
"command": "npx",
"args": [
"-y",
"thebrain-mcp-server"
],
"env": {
"THEBRAIN_API_KEY": "<thebrain-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"thebrain-ybookoff": {
"command": "npx",
"args": [
"-y",
"thebrain-mcp-server"
],
"env": {
"THEBRAIN_API_KEY": "<thebrain-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"thebrain-ybookoff": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"thebrain-mcp-server"
],
"env": {
"THEBRAIN_API_KEY": "<thebrain-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"thebrain-ybookoff": {
"command": "npx",
"args": [
"-y",
"thebrain-mcp-server"
],
"env": {
"THEBRAIN_API_KEY": "<thebrain-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| THEBRAIN_API_KEY | yes | yes | Local API key from TheBrain: Settings > User > Local API Key |
| THEBRAIN_BASE_URL | — | — | Address of the local API. Default http://localhost:8001 |
| THEBRAIN_DATA_DIR | — | — | Where semantic indexes are stored. Default ~/.thebrain-mcp |
| THEBRAIN_ALLOW_DESTRUCTIVE | — | — | Set to 1 to allow deleting thoughts. Deletion still requires human confirmation. Default 0 |
| THEBRAIN_EMBEDDING_MODEL | — | — | Embedding model for semantic search. Default Xenova/multilingual-e5-small |
| THEBRAIN_EMBEDDING_DTYPE | — | — | Weight precision: fp32, fp16, q8 or q4. Default q8 |
| THEBRAIN_TIMEOUT_MS | — | — | API request timeout in milliseconds. Default 30000 |
Freshness
Active — last maintenance signal 10d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-30 · 10d ago · GitHub
Latest release
2026-09-30 · 10d ago · GitHub · v0.1.4
Package published
no data · npm/PyPI
Registry entry updated
2026-09-30 · 10d ago · official registry · v0.1.5
FAQ
›How do I install the Thebrain MCP server in Claude Code?
Run: claude mcp add thebrain-ybookoff -e THEBRAIN_API_KEY='<thebrain-api-key>' -- npx -y thebrain-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Thebrain require an API key?
Yes. It expects THEBRAIN_API_KEY, of which 1 is a secret.
›Can I use Thebrain as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Thebrain in the official MCP registry?
Yes, as io.github.yBookoff/thebrain.