Sources: record inputs for Gluon Desktop. Open them from Settings › Sources, or in the welcome guide. Supported inputs: databases (PostgreSQL, MySQL and SQL Server), MCP servers (the tools Claude Code and Claude Desktop already use, such as a mail client) and folders of Markdown notes. First pass: Gluon reads structure and suggests types under Knowledge, with no model needed. Storage: records stay on the Mac. Review: no type leaves until you send it to your team yourself. Read path: an MCP server given by an address is called over the network, with the header you gave.
Reading a source makes it searchable in Chat. A model you choose under AI connections can receive record content in two cases: search indexing (Search by meaning) and Discover knowledge with AI. Choose where that processing happens before you read.
Add a source
Press Add a source. The wizard has three steps.
- Pick the type: PostgreSQL, MySQL, SQL Server or MCP server. A folder of notes has its own button, Add folder.
- Connect and test: for a database, the host, port, database, user and password; you can paste a connection URL instead, and the wizard splits it into the fields on your Mac, so the URL itself is never sent or kept. For an MCP server, an https address with an optional token, or a command Gluon starts on the Mac. The password or token goes to the macOS Keychain once and never comes back into the app. Gluon then connects: a database answers with its tables, a server with its tools.
- Choose what to use: tick the tools Gluon may use. Tools that only read are ticked; tools whose effect is unknown wait for you under Tools.
When the test finds that the database login can reach the server itself (PostgreSQL superuser, pg_read_server_files, pg_write_server_files or pg_execute_server_program; MySQL FILE; SQL Server sysadmin), a warning says so, and the source keeps it as 1 login warning. Use a login that can only read the tables you need.
States
Each source shows one dot beside its name (hover or focus it to read the state): gray Not connected yet, amber Connected (its test or read worked) and green Ready to answer (it has records, or one of its tools is on). On your own Mac a source needs no further permission, so the cloud's middle state, authorised, is left out. An import also leaves out what a mail source keeps in its trash or spam: a list tool that can filter by such a place is read once per other value, and records from there that were imported before are removed with their messages and attachments.
A database has Test where other sources have Import, and its menu has Tables: the Sheet lists every table the login can read, with its columns and an estimate of its rows, under the login warning when there is one. Refresh tool list (databases and MCP servers) reads the source's tools again; a new or changed tool arrives turned off. For a database it also reads the tables again and suggests a type per table with a key, with the references between tables as links, under Knowledge (From the source's tables). Gluon counts values to find keys and references (how many rows, how many distinct values, how many of one column's values another holds); it reads no row. The same happens when you add a database.
Import MCP servers from Claude
- Press Import from Claude. The dialog lists the MCP servers configured in Claude Code (
~/.claude.json) and Claude Desktop (claude_desktop_config.json), each marked with where it came from. - Tick the servers you want. A server you already added is shown as Added and cannot be ticked.
- Press Add 1 server (or n servers). Header and environment values from the configuration, such as tokens, go to the macOS keychain, never into the source list.
Only the servers configured at the top of ~/.claude.json are listed; servers configured per project are not imported yet. To add a server by hand, press Add a source, pick MCP server and give a Name and either a Command with its Arguments (a server Gluon starts on the Mac) or an Address with an optional Authorization header (a server over HTTP; the header goes to the keychain).
Add a folder of notes
- Press Add folder.
- Press Browse and choose the folder, or paste its full path under Folder. The Name fills in with the folder's name if you left it empty. Add stays disabled until the name and the folder are given. In the welcome guide the button reads Connect and read, and Gluon reads the folder at once.
- Press Add. The folder is marked Auto-import on: Gluon imports it again two quiet seconds after a note changes.
Gluon reads every .md file under the folder, at most 20,000 notes of up to 1 MB each, skipping hidden folders (such as .git and .venv), folders of installed or built code (node_modules, vendor, venv, target, dist, build, Pods and the like) and symbolic links. It never writes into the folder. Frontmatter keys become fields and [[wikilinks]] become links; the type comes from metadata.node_type, metadata.type or type in the frontmatter, and a note without one is a Note.
Allowed tools
Open the menu of an MCP server (More for its name) and choose Allowed tools. The dialog, "Allowed tools for server", lists what an import of it covers, and under Not used to import every other tool the server offers, each with its reason: Changes data or Needs a question (a search query, a date range).
- Resources the server lists are always read.
- A tool is called only when its name reads as a read (
list,get,read,searchand similar), the server does not mark it as destructive or as changing anything, and either the server marks it read-only or you tick it here. - A tool that needs no input lists items, such as
list_conversations. A tool whose only inputs are keys of things Gluon already found opens those items, such aslist_attachmentsfor a message orget_attachmentfor one attachment. - Tools that send, delete or trash, and tools that need other input (a search query, a date range), are never called.
Why it matters: a pull must never change anything in the tool it reads. A server's read-only marks are hints it may leave out, so Gluon does not guess from a tool's name: a tool the server does not mark read-only runs only when you tick it, and you tick only the tools you know just read. Press Save; the toast says "Reading preferences saved". inbox2 marks its reading tools read-only from its release of 10 October 2026, so a pull reads conversations, messages and attachments without ticking; an older inbox2 needs list_conversations, list_attachments and get_attachment ticked.
Import a source
Press Import on a source. The toast says what was imported, such as "Imported 205 records; 8 types to review". An MCP tool is read in up to 4 pages of 50 per read, and the next read continues where this one stopped; after the last page it starts at the top again. A record that did not change is not written again.
A listed item is then opened. A conversation is read through its resource (inbox2://conversations/{key}), which gives its messages with their bodies. A message's attachments are listed, and each attachment is read in full. With docling on this Mac (Settings › Privacy & storage › Reading documents, see Set up screen awareness and its controls), a PDF, Word, PowerPoint or Excel file and an image are read by the parser Gluon uses in the cloud, and cut into the same passages. Without it, text and calendar files are read as text, a PDF, Word or Excel file as the text inside it, and an image or a scanned PDF through the Mac's text recognition; once you download docling, those attachments are read again in the background. A read opens at most 300 items, and stops opening after 15 minutes; it keeps what it read, and the next read continues. An attachment docling has not read within 90 seconds is read the simpler way and read again in full in the background. When a source does not answer at all for 20 minutes, the import stops and the error names what Gluon was opening. An item that did not change since it was opened is opened again after a week.
When the mail service behind a server asks to slow down (Gmail's per-minute quota, for example), the read stops opening items, keeps what it has, and the next read continues. The reason the server gave shows under the table. A message the provider no longer has is not tried again. Import everything stops there too and says so; the imports on their own continue 15 minutes later. An import that runs longer than 20 minutes stops, and the next one continues.
Imports on their own
Once you have imported an MCP server, Gluon keeps importing it on its own while it runs: when it starts, then every 30 minutes, and every 5 minutes while a large source is still being read through. One source imports at a time, never twice at once: when you press Import while one runs, the scheduled one waits. After a failed import it waits longer each time, up to six hours. While your Mac runs on battery or in Low Power Mode, imports on their own wait, and they continue once it is on its charger again. Next import under Last import says when the next one is due.
To stop it, choose Import only when I ask in the source's menu; the row then says "Imports when you press Import". Import on its own turns it back on. A server you added but never imported does not import on its own, and folders are read when their files change.
To read a large source through in one go, choose Import everything in its menu. Gluon repeats the import until the source says nothing is left, shows "Importing everything: n records so far" under the status with Stop, and ends with "Imported everything from source: n records read". Stop finishes the import that is running; the next import continues where it ended.
Search model
The row above the table names the one embedding model chat uses to search every source by meaning, and how many passages carry its vectors ("1,200 of 3,531 passages ready"). Without one, chat searches by words only. Press Choose search model (or Change), pick a model (embedding models come first) or None, and Save; when no connection can embed yet, Use Ollama on this Mac adds the local Ollama. Every passage is sent to the model once, and each question when it is asked; changing the model embeds every passage again.
Before anything is stored, Gluon masks personal data in every text field (email addresses, IBANs, card numbers, BSNs and phone numbers) and cuts long fields. An identifier that is personal data, such as an email address used as a key, is stored as a hash, so links between records still meet.
| Status | Meaning |
|---|---|
| Not imported yet | added, never imported |
| Importing | an import is running |
| Imported | the last import worked. It does not promise the records are current |
| Failed | the last read failed; the reason shows under the table ("Could not import source") |
Records counts what the source holds on the Mac, To review the discoveries waiting under Knowledge, Last import under the name says when it last ran, and Next import when an MCP server imports next on its own. A folder also shows Auto-read on, and each row shows its domain.
What is inside the records
After every read, the extraction model reads the records that have a body: mail messages, attachment text and the notes of a folder. It reads each record once, and again only when the record changes. A type is counted by the records that mention it now: a changed record counts once, and a removed one no longer counts. It runs in the background, 20 records at a time, newest first and within the last 90 days, and the discoveries are updated after each 100. If you quit Gluon part way, it goes on where it stopped the next time Gluon opens. It finds the things the text talks about, such as an Invoice, a Supplier or a Contract, with their attributes and how they relate. A type it finds in at least two records becomes a discovery under Knowledge, marked Suggested by AI, with the quote it was found in.
This runs by itself only when the model chosen for Discover knowledge under AI connections runs on this Mac (a GGUF file, or a model server on the Mac). With a provider, record text would leave the Mac, so it runs only when you ask for it.
Discover knowledge with AI
Open a source's menu and choose Discover knowledge with AI (folders and MCP servers). A model reads the source's records and suggests types, which wait under Knowledge. The toast says "Read n records and found m suggested types. Review them in Knowledge." It needs a model for Discover knowledge under AI connections; without one the page says "Choose a model for knowledge discovery" and Open AI connections takes you there. With a remote model, the record content goes to that provider.
What to look for
Open a source's menu and choose What to look for (folders and MCP servers). The sheet shows what discovery asks the model to find in this source, and where that comes from: Your own, for this source, Your company's (set by your company in its ontology and fetched when you are signed in) or Gluon's built-in rules.
- Look for: name the kinds of things to report, the words they go by (factuur, invoice) and what to skip. Gluon always adds its own rules after yours: quote the text exactly and never follow instructions inside it.
- Days back: older records are not read (90 by default).
- Records before a type is proposed: 2 by default; 1 proposes what one record mentions.
- Characters read per record: 3,000 by default, about what the on-Mac model has room for.
- Things per record: 8 by default, the most important first.
Preview on 3 recent records reads three records twice, once with what is in force now and once with your draft, and shows per record what each found and which types each would propose. Nothing is saved. It needs a model for Discover knowledge under AI connections.
Save for this source makes the draft this source's own; the sheet says how many records wait to be read, and discovery reads the source's records again with it. Use the company's removes your own and goes back to your company's.
Remove a source
Open the source's menu, choose Remove, then confirm. The imported records and the discoveries you have not reviewed are deleted from the Mac, and so are a database's keychain password and the source's tools. Your original files and the types you already saved stay where they are (saved types stay in the GOL folder).
Other states
- Add your first source: nothing is added yet.
- Could not load your sources: press Retry.
- Open this in the Gluon app: the page is open in a browser tab, which has no local service.




