Brain is your company knowledge base for agents. Connect your tools once, and your agents can search everything your team knows.
Your agents can already take actions through connectors and follow your processes through skills. What they cannot do out of the box is know what your company knows: your documents, your Slack threads, your past decisions, and where any of it lives.Brain is where that knowledge lives.You connect the tools your team already uses, Gumloop indexes them, and your agents can then search across all of it and answer from your real content, with citations, instead of guessing.
Brain is available on the Pro and Enterprise plans.
They work together. An agent might search Brain for your pricing policy, follow a skill to format a quote, then use a connector to email it.
The mental model for the rest of this page: indexing a source makes knowledge available; attaching it to an agent makes that knowledge usable by that agent.
Everyone in your organization can see and search it, or only the teams you choose. Often set up once by an admin for the whole company.
Your data stays yours. Indexed content is used only to answer your own team’s agents. The embedding provider Gumloop uses runs under a zero-data-retention policy, so your content is not retained by it or used to train third-party models, and Brain respects incognito chats.
By default, source scope is the only gate: anyone who can see a source can search everything indexed in it. For Google Drive sources, you can go further and have Brain honor each document’s own Drive permissions. You set this when adding a source (and can change it later on the source’s settings), under Document access:
Original source
Only people with access to a document in the original source can retrieve its content through Brain. Google Drive permissions are checked per document.
Gumloop access
Anyone with access to this source in Gumloop can retrieve any document indexed in it, regardless of the original system’s permissions.
Document access appears only for sources that support it. Google Drive is the only supported source today; other source types always use Gumloop access.
When Original source is set, Gumloop snapshots each document’s Google Drive permissions during sync and enforces them at search time. A user only retrieves a document if they have access to the underlying Drive file, matched by the email on their connected Google account.
Some Google Drive grants can’t be enforced and stay private. Direct user access and organization/domain access (matching your verified email domain) are honored. Documents shared only through “anyone with the link”, or with a Google Group, are treated as no access and won’t surface to those users — Brain fails closed rather than over-share. Grant people or your domain access directly in Drive if you want those documents retrievable.
With Gumloop access, Brain does not check the source’s own per-document permissions. Anyone who can see the source can retrieve anything indexed in it — including files they could not open directly in the original system. Scope such sources to the audience you intend. See sharing and permissions.
Changing a source’s Document access setting queues a re-sync so permissions are re-snapshotted against the new mode.
A knowledge source is a connection to a place your knowledge already lives. Gumloop reads from it, indexes the content, and keeps it in sync.
Supported source types in the Add a source dialog.
Don’t see your app? You can also sync almost any other app in Gumloop’s connector library, no native source required. See Build your own sources.
1
Open Add a source
On the Brain page (or an agent’s Knowledge Sources section), click + Source and pick a source type.
2
Name it and pick an account
Give the source a clear, descriptive name. This is how agents and your team will see it. Then choose the connected account Gumloop should use to read the content.
Naming a Google Drive source and choosing the account used to read it.
3
Choose exactly what to sync
Narrow the source to only what you want indexed: specific drives, folders, channels, spaces, or repositories. Everything you include inherits the source’s scope, so pick with the audience in mind.
Selecting which Google Drive folders to sync.
4
Set Document access (supported sources)
For sources that support it (Google Drive today), choose how retrieval permissions work: Original source to honor each document’s own permissions, or Gumloop access to let anyone with access to the source in Gumloop retrieve its content. See Document access below.
5
Choose organization access (organization sources)
When you add a source to Organization Brain, a final step controls who in your org gets it: everyone organization-wide, or only specific teams. Personal and team sources skip this step.
6
Add the source
Click Add source. Gumloop starts crawling and indexing.
Brain reads the text in your content. What that means per source:
Source
What gets indexed
Notion
Full page content for the pages and databases you connect.
Google Drive
File contents from the drives and folders you pick, including Google Docs, Sheets, and Slides (converted for indexing). Folders organize results but are not documents themselves.
Slack
Messages, including thread replies, from the public channels you choose.
GitHub
Files from the repository you connect.
Confluence
Pages from the Confluence space you connect.
Zendesk
Help Center articles from the categories and sections you pick, and support tickets, including each ticket’s subject and full comment thread.
File uploads
The files you upload: PDFs, Office files (.docx, .pptx, .xlsx), rich text, Markdown, JSON, XML, YAML, and plain text, up to about 400 MB each.
Brain does not run OCR on images, so text inside images or scanned pages is not indexed. Private Slack channels are not synced.
The source types above are purpose-built and give the best experience. For anything else, you can sync almost any app in Gumloop’s connector library, the same 100+ integrations your agents already use, even when there’s no native source for it (Gmail, Linear, Intercom, HubSpot, Jira, and more).Instead of a fixed form, a short AI setup chat inspects the app for you, proposes what’s worth syncing, and turns it into the same picker-and-toggle experience as a native source. Nothing is added until you approve the plan.
1
Pick the app
In Add a source, search for the app. Apps without a native source appear under Build your own.
Apps without a native source appear under 'Build your own' in the Add a source dialog.
2
Connect an account and (optionally) say what you want
Choose the account Brain should read from, then optionally describe what to sync (for example, “our support emails”). Leave it empty and the setup chat suggests a sensible default.
3
Approve the proposed plan
An assistant explores the app, works out how its content is organized, and proposes what to sync. Review its summary and choose Looks good or Request changes.
The setup chat proposes what to sync and asks you to approve or request changes.
4
Choose exactly what to sync
On the selection screen, narrow the source to only what you want indexed, using the app’s own concepts (labels, folders, channels, projects). Then click Add source.
The selection screen, built from the approved plan. Sync everything or hand-pick what to include.
It inspects the app to learn how content is organized and which parts are worth making searchable.
It proposes a plan as a plain-language summary of what you’ll get, not a list of settings.
It may ask a question when a choice is genuinely yours (which workspace, which username), always with options to pick from.
You approve or request changes.Looks good moves you to the selection screen; Request changes tells it what to adjust, and it reworks the plan.
The setup chat is read-only. It only reads from the connected account to plan and sync the source, and never creates, edits, or deletes anything in your app.
Give it a hint on the connect step for a more tailored plan, e.g. “just our #announcements channel” or “deals closed this year”. Anything specific you mention is carried onto the selection screen so you don’t re-enter it.
The selection screen is built from the approved plan, so the exact controls depend on the app. You’ll typically see:
Control
What it does
Sync by
When an app can be organized more than one way, pick the dimension to sync by (for example, Labels vs. a search query).
Sync everything
Index the whole source, including content added later.
Select what to sync
Hand-pick only the containers you check, such as specific labels, folders, or channels.
What to include
Toggle which content streams are indexed (bodies vs. comments, say). Core content is on by default.
Search box / queries
For content reachable only by an identifier or query (a username, a channel, a search), type the values to pull in.
Everything you include inherits the source’s scope, so pick with your audience in mind. The account works like any source: on Team Brain you can pick a team or personal account; on Personal and Organization Brain you pick a personal account.
Apps with a native source (Notion, Google Drive, Slack, GitHub, Confluence) use their dedicated setup instead and don’t appear here.
Action-only and scraping platforms (web-scraping, enrichment tools) have no content library to sync, so they’re hidden.
Raw database and warehouse apps aren’t offered, because syncing them safely would need write-capable access that Brain never uses.
Empty accounts or missing permissions — the setup chat tells you rather than creating an empty source, so you can switch accounts. If setup can’t finish (including running out of credits) the source shows Setup failed with a short reason; fix the cause and set it up again.
Once a source is added, Gumloop takes over. You do not manage any of this:
1
Crawl and index
Gumloop reads the source, detects what is new or changed, and indexes the content for both semantic (meaning-based) and keyword search. The source moves to Active and its items show as Indexed.
2
Stay in sync
External sources re-sync automatically (by default about hourly for connectors like Google Drive), so answers reflect the latest version. If a document is deleted or moved out of a source’s scope upstream, the next successful sync removes it from Brain too. File uploads do not auto-sync because there is no remote system to poll.
How long until it is searchable? Indexing time depends on the source’s size, from a minute or two for a small source to longer for large ones. The Status column shows progress and flips to Active once items are indexed and ready to search.
If your admins have already set up Organization sources, they appear under the Organization tab and are ready to search right away. You do not need to add anything yourself to start benefiting from Brain.
Open the ⋮ menu on any source for its management actions:
The per-source actions menu.
Re-sync
Force an immediate sync to pull the latest content without waiting for the next scheduled run.
Pause
Stop syncing and stop any running indexing work. Already-indexed content stays searchable. Resume any time.
Control access
Change who can see and search the source. For organization sources this controls whether it’s available org-wide or only to specific teams; you can also change a source’s Document access from its settings.
Rename
Change the display name your team and agents see. Renaming does not re-index anything.
Delete
Remove the source and all of its indexed chunks from Brain. This cannot be undone.
A newly added build-your-own source is being wired up before its first sync. Flips to Active on its own.
Setup failed
A build-your-own source couldn’t be set up (for example, an empty account or out of credits). Shows a short reason; fix it and set the source up again.
Paused
Syncing is stopped until you resume it.
Syncing
A sync is currently running.
Indexed
An item has been processed and is searchable.
Failed
The last sync hit an error. Re-sync or check the connected account.
Partial
The last sync finished, but some items did not index.
Every Brain view includes a knowledge graph: an interactive 3D map of everything you have indexed. Each point is a piece of your knowledge, clustered by source and colored so you can see how your Slack, Drive, Confluence, and other content group and connect. Click View knowledge graph or Expand to open it full screen and drag to explore.
The expanded knowledge graph. Each cluster is a source; each point is indexed content.
Adding a source to Brain makes it available. To let a specific agent use it, attach it in that agent’s configuration.
The Knowledge Sources section in an agent's configuration.
1
Open Knowledge Sources
In the agent’s configuration, find the Knowledge Sources section and click + Source.
2
Attach sources
Pick from your Personal, Team, and Organization sources, or Upload files to add knowledge straight to this agent. You can drill into a source to attach only the exact files or folders that are relevant, so the agent searches a focused set.
Attaching Brain sources to an agent, grouped by scope.
Once a source is attached, the agent gets two built-in tools automatically:
Search Company Brain runs a hybrid search across the attached sources and returns the most relevant snippets. In chat this shows as Searching Company Brain.
Read document fetches the full text of a specific document when a snippet is not enough. In chat this shows as Reading document.
The agent decides when to search. When you ask about internal knowledge, it searches Brain, cites what it found, and can open a full document for more context.
Once knowledge is attached, you use the agent normally. It reaches for Brain when a question is about your internal content, often running several searches at once and citing the sources it used.
An agent answering from Brain: it runs multiple searches, then cites the source it used.
Prompts that work well:
“According to our internal docs, what is our refund window?”
“Find the launch retro notes and summarize the top three action items.”
“What did we decide about pricing in the Slack thread last quarter?”
“Search our knowledge base for the onboarding checklist and turn it into an email.”
Nudge the agent toward Brain when you want a grounded answer: phrases like “according to our docs,” “search our knowledge base,” or “what do we know about” make it clear you want a cited answer from your content, not a general one.
Beyond the sources you connect, Gumloop can index the artifacts your agents produce, the files they generate for you in chat, so agents can search and reuse past work instead of starting from scratch.
Artifacts are indexed at the Personal (your artifacts) or Team (a project’s artifacts) level.
Only the newest version of each artifact is indexed, and it updates in place when a new version is produced.
Agents find them with the same Search Company Brain and Read document tools, so “pull up the deck we made last week” works like any other knowledge lookup.
Brain search isn’t limited to agent chats. The same hybrid search is available anywhere you build, scoped to the sources the authenticated user can access:
REST API
POST /brain/search — search from any language over HTTP.
The search_brain tool, callable from any MCP client.
Each of these accepts a query, an optional result limit (1–50), and an optional source_type filter, and returns ranked snippets with their title, source, URL, relevance score, and owner metadata.
Brain is knowledge your agents can search (documents, messages, files). Skills are instructions that teach an agent how to do a task your way. Use Brain for “what do we know about X,” and skills for “here’s our process for doing X.”
My app isn't in the list of source types. Can I still sync it?
Usually yes. Beyond the native source types, you can build your own source from almost any app in Gumloop’s connector library. An AI setup chat inspects the app, proposes what to sync, and you approve it, no technical configuration needed. Apps that already have a native source, and action-only or raw-database apps, are the exceptions.
Can building my own source change anything in my app?
No. Both the setup chat and ongoing sync are strictly read-only. They only read content to index it and never create, edit, or delete anything in the connected app.
How is Brain different from connecting an app like Google Drive as a tool?
A connector lets an agent take live actions and fetch specific items on demand. Brain pre-indexes your content so the agent can do fast, semantic search across everything at once, with citations, instead of navigating a tool call by call.
How long until my content is searchable?
It depends on the source’s size, from a minute or two for a small source to longer for large ones. The source shows Active and its items show Indexed once they are ready.
If I delete a document in the source, does it leave Brain?
Yes. When a document is deleted or moved out of a source’s scope upstream, the next successful sync removes it from Brain. To remove an entire source, use Delete.
Is my data used to train models?
No. Your indexed content is used only to answer your own team’s agents, and the embedding provider Gumloop uses runs under a zero-data-retention policy, so your content is not retained by it or used to train third-party models.
Who can see the sources I add?
It depends on the source’s scope. Personal sources are visible only to you, Team sources to that team, and Organization sources to everyone in your org (or only the teams you pick). Anyone who can see a source can search everything indexed in it, unless you set the source’s Document access to Original source (Google Drive), which additionally honors each document’s own permissions.
Can Brain respect my Google Drive file permissions?
Yes. When you add a Google Drive source, set Document access to Original source. Brain then snapshots each file’s Drive permissions on every sync and only lets a user retrieve a document if they have access to it in Drive. Files shared only via “anyone with the link” or a Google Group stay private in Brain.
What can I upload as a file source?
Common document formats such as PDFs, Office files (.docx, .pptx, .xlsx), rich text, Markdown, JSON, XML, YAML, and plain text, up to about 400 MB per file. Unsupported types are rejected, and Brain does not read text inside images.
Can agents use files they created themselves?
Yes. Gumloop can index your agents’ artifacts at the Personal or Team level, so an agent can search and reuse past outputs. Only the newest version of each artifact is indexed.
Can I search Brain myself, not just through an agent?
Yes. Each source has a Search this source box, and the Brain page has a global search so you can find and preview content directly.
What plans include Brain?
Brain is available on the Pro and Enterprise plans.
