How often do I need to reconnect?

Once every 30 days. Tokens auto-refresh in the background within that window, so day-to-day use is uninterrupted. If you change your Brain Graph password, all active connector sessions are invalidated at once.

Is there a cost for the connector?

The connector itself is free for every Brain Graph plan — Free, Pro, and Max. Standard plan limits for uploads and queries apply.

Does the connector work in claude.ai web as well as Claude Desktop?

Yes. The same connector URL (https://mcp.itsbraingraph.ai/mcp) works in both surfaces. Add it once in either, or both — they share no state on Claude's side, so independent sessions are fine.

What tools does the connector expose?

Four tools in v1: search_brain (natural-language search), resolve_entity (look up a person, organization, project, or topic), upload_text (save a short note), and upload_document (save a longer document with optional title, date, and metadata). More tools coming — including async agent tools and structural pattern queries.

Brain Graph MCP — Connect Your Knowledge Graph to Claude

One-click install — talk to your Brain Graph from any Claude chat (Claude Desktop or claude.ai web). No API keys, no config files, no domain whitelists. Each connection is OAuth-secured against your Brain Graph account.

What you can do from Claude

Eleven tools, available the moment the connector is added. Claude picks the right one based on your prompt (no need to mention tool names). Drop in notes, files, longer documents, web articles, YouTube videos, and voice memos; browse everything you've uploaded; pull images out of documents you have already uploaded; switch between multiple brains; ask questions across everything you've captured.

search_brain — Natural-language search across every fact, document, and relationship in your knowledge graph.
resolve_entity — Look up a person, organization, project, or topic and get its canonical record (UUID + attributes).
list_documents — Browse everything you've uploaded, newest first: filename, upload date, and which brain it landed in. Filter by a search term to find a document by name.
get_document_images. Pull figures, diagrams, screenshots, or slides from one of your uploaded documents and render them inline in chat. Works on PDFs, DOCX, PPTX, and ingested URLs with body images.
upload_text — Capture a short note, thought, or decision directly from chat — straight into your graph.
upload_to_brain. Drop a PDF, Word doc, slides, image, or audio file straight into a Claude conversation. The connector opens a secure upload widget and runs the right pipeline. Audio up to ~150 MB, documents up to ~35 MB.
upload_document — Save longer content (transcripts, articles, structured notes) with optional title, conversation date, and metadata.
upload_url — Drop a URL and your brain ingests the article: fetches the page, extracts the readable body, and indexes it like any other document.
upload_youtube_url — Paste a YouTube URL and your brain ingests the video: pulls the transcript, resolves the speakers, and indexes the content. Each video is processed once.
upload_audio_url. Share a public link to an audio file (voice memo, recording, podcast). Your brain transcribes it with speaker diarization, then indexes it like any other document.
list_brains. See your separate brains (Personal, Marketing, Learning…). One connection spans them all. Claude searches everything by default and only narrows when you name a brain.

Setup in three steps

Open Claude → Settings → Connectors. In Claude Desktop the menu is in the sidebar; on the web, visit https://claude.ai/settings/connectors.
Click "Add custom connector" and paste the connector URL https://mcp.itsbraingraph.ai/mcp. The /mcp suffix is required — it is the protected MCP transport endpoint and the OAuth resource Claude binds your token to.
Sign in with your Brain Graph email and password (the same credentials you use at itsbraingraph.ai). Claude redirects you back fully connected and the eleven tools appear immediately.

Example prompts to try

"Search my brain for what I learned about pricing last quarter."
"Look up Sarah Chen in my Brain Graph."
"Save this note to my brain: Connector beta shipped 2026-05-13."
"Save this transcript with title 'Team sync 2026-05-13' and content..."
"What do I already know about Brain Graph monetization?"

Security and your data

Claude receives an OAuth token scoped to your Brain Graph account only — there is no shared key, no bulk credential. Tokens are stored encrypted on your device by Claude Desktop or claude.ai. The Brain Graph server verifies user identity on every tool call, including a cross-check that the OAuth grant matches the JWT user. Mismatches and authentication failures are refused before any data is read or written.

Beta status

v1 ships eleven tools, including in-chat file upload, image extraction from documents, browsing your uploaded documents, and multi-brain support. Coming next: async agent tools (meeting prep, opportunity scout), structural pattern queries, time-windowed search. Connections last 30 days and tokens auto-refresh in the background, so day-to-day use is uninterrupted. The connector is currently a custom-URL install; the public listing in the Claude Connectors Directory is under review.

Support

Bug or feature request? Email support@itsbraingraph.ai. Need a Brain Graph account first? Start free at itsbraingraph.ai/pricing — 40 documents on the Free plan, no credit card.