BrainTube
Save once.
What it can do
- Search Knowledge: Full-text search over your personal BrainTube knowledge corpus. Searches across YouTube, Instagram, web, LinkedIn, GitHub, Twitter and more.
- Get Video: Get full details for a specific saved item including transcript, description, summary, key takeaways. Pass YouTube video ID or internal UUID.
- List Recent: List your most recently saved items across all source types.
What data it sees
Do you need an account
No: the server works without sign-in
Save once. Query anywhere. BrainTube turns everything you save — YouTube, articles, podcasts, PDFs, Notion, Obsidian, web — into a personal knowledge base any AI can search. Semantic search, knowledge graph, expertise profiles, and ingest tools, from Claude, Cursor, or any MCP client.
How to connect
How to connect BrainTube to Claude
The server address to paste into Claude settings:
https://mcp--braintube.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect BrainTube to ChatGPT
The server address to paste into ChatGPT settings:
https://mcp--braintube.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect BrainTube to Cursor
The server address to paste into Cursor settings:
https://mcp--braintube.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (52)
Raw names from tools/list. Only developers need these.
| search_knowledge | Full-text search over your personal BrainTube knowledge corpus. Searches across YouTube, Instagram, web, LinkedIn, GitHub, Twitter and more. |
| get_video | Get full details for a specific saved item including transcript, description, summary, key takeaways. Pass YouTube video ID or internal UUID. |
| list_recent | List your most recently saved items across all source types. |
| get_stats | Get your personal corpus statistics: total items saved, breakdown by source type, taint distribution. |
| get_related | Find items semantically similar to a given item using vector similarity. |
| search_by_source | Search your corpus filtered to a specific source type (youtube, web, notion, twitter, pdf, etc). |
| search_by_date_range | Semantic search scoped to items saved between two dates. |
| tag_item | Add or remove tags on a saved item. |
| list_bookmarks | List saved bookmarks from your corpus. Filter by read/unread status. |
| toggle_bookmark | Bookmark an item, remove a bookmark, or toggle its read/unread state. |
| connect_readwise | Connect your Readwise account to BrainTube by saving your Readwise API token. |
| sync_readwise | Import highlights from your Readwise library into your BrainTube corpus. |
| ingest_notion_page | Ingest a single Notion page into your BrainTube corpus. |
| add_note | Write a note or AI-generated synthesis back to a specific item in your corpus. |
| get_recent_conversations | Retrieve your most recently saved Claude and ChatGPT conversations. |
| get_expertise_profile | Analyse your corpus to build a knowledge expertise profile — expert, intermediate, surface, and blind spots by topic. |
| get_session_brief | One-shot session bootstrap: expertise profile, last 5 AI conversations, and corpus stats in a single call. |
| ingest_content | Ingest a single piece of content (note, article, document, etc.) into your BrainTube corpus. |
| bulk_ingest | Ingest up to 50 items in a single call with dedup and embedding. |
| random_resurface | Surface forgotten items from your corpus using weighted randomness. |
| ingest_notion_database | Ingest all pages from a Notion database into your BrainTube corpus. |
| set_notion_api_key | Save your Notion integration API key for ingest_notion_page and ingest_notion_database. |
| backfill_embeddings | Generate vector embeddings for all items that are missing them. Required before semantic search. |
| generate_api_key | Generate a personal API key for Obsidian Sync CLI or other integrations. Key shown once only. |
| search_obsidian | Search your local Obsidian vault via the Obsidian Local REST API plugin. |
| chat_with_brain | Ask a question to a public BrainTube Brain (curated knowledge base). Returns answer + source citations. |
| list_brains | List all Brains you have created with slug, name, item count, and visibility. |
| get_knowledge_graph | Build a knowledge graph around a specific item, showing how it connects to others via knowledge_edges. |
| knowledge_health | Run a health check on your knowledge corpus: missing embeddings, stale items, gaps, overall score out of 100. |
| get_knowledge_index | Get a topic-level index of your entire knowledge corpus grouped by primary topic. |
| export_corpus | Export your entire BrainTube knowledge corpus as a ZIP of Markdown files. Returns a signed download URL. |
| compile_knowledge | Generate concept articles from a topic cluster or Brain via the compile-knowledge edge function. |
| get_concept_articles | Query compiled concept articles from your knowledge base, filter by cluster, brain, or search text. |
| tag_cooccurrence | Find tags that frequently appear together across your corpus. |
| entity_cooccurrence | Find named entities (people, orgs, tools) that frequently co-appear across your corpus. |
| detect_gaps | Detect knowledge gaps: thin topics, entities without depth, stale high-value items. |
| most_retrieved | Return the items you retrieve most often, ranked by retrieval_count. |
| export_claude_md | Generate a CLAUDE.md-compatible knowledge context file for any Claude Code project. |
| recompute_salience | Trigger a salience score recompute across your corpus. |
| deep_search | Multi-hop knowledge search: semantic search + graph traversal from top results. |
| retrieval_quality | Get a retrieval quality dashboard: search hit rates, zero-result queries, top terms. |
| find_path | Find the shortest path between two items in your knowledge graph. |
| compute_centrality | Recompute graph centrality scores across your corpus. |
| get_edge_history | Get temporal history of knowledge edges between two specific items. |
| security_dashboard | Get current security alert status, recent events, taint distribution. Admin only. |
| acknowledge_security_alert | Acknowledge a security alert by UUID. Admin only. |
| suppress_alert_type | Temporarily suppress a specific alert type for maintenance windows. Admin only. |
| firewall_status | Get LLM firewall status, analytics, shadow mode state, and threshold recommendations. Admin only. |
| firewall_promote_check | Promote a firewall check from shadow mode to enforcement or demote back. Admin only. |
| firewall_update_threshold | Update a firewall threshold value with automatic versioning. Admin only. |
| firewall_rollback_rules | Rollback firewall rules to a previous version. Admin only. |
| firewall_rule_history | View version history for a firewall rule type. Admin only. |