AI agents · new in version 1.5
Your AI agent finds and tidies your files. You stay in charge.
Claude, ChatGPT, Gemini, Grok, Claude Code, Cursor and others use Folia Files through MCP. The agent thinks; Folia shows and does: it searches like Folia, shows what it found in a tab, saves your layouts — and every change it proposes waits for your OK in a Folia sheet.
- Every change approved by you
- Undo with ⌘Z
- Off until you turn it on
7 days free with every feature, no account, no card.
Claude proposes, Folia Files shows the plan in a sheet, you apply — and ⌘Z undoes it all.
It searches by name and by the text inside documents, then shows exactly what it found in a Folia tab.
It finds pictures by what they show, then saves the layout as a scene you open again from the Layouts menu.
Read only: it measures the disk the way Space Lens does and opens Space Lens for you. Nothing is changed.
With “Read the content of documents” turned on, it reads the scans. You untick what you don't want, then apply.
Claude proposes, Folia Files shows the plan in a sheet, you apply — and ⌘Z undoes it all.
In short
Since version 1.5, Folia Files lets AI agents work with your files through MCP (the Model Context Protocol): Claude and ChatGPT for Mac, Claude Code, Codex, Cursor, VS Code, Grok Build, and Gemini for Mac where Google has opened its Local MCP tab. The agent searches your files the way Folia does — by name, by the text inside documents, by what pictures show, by tag —, shows its results in a Folia tab, saves scenes and workspaces, measures a disk or finds duplicates. Its changes (creating folders, moving, renaming, tagging, compressing, the Trash) are only proposals: you validate them in a Folia sheet, nothing is overwritten, and everything can be undone. It is off until you turn it on, in the website edition.
What you can ask
Plain requests, in your own words. A few that work well:
Tidy up
Tidy my Downloads: one folder per kind, and the duplicates to the Trash.
One proposal: new folders, files moved, copies to the Trash. You untick what you want to keep.Rename these scans with their date and the shop's name.
With “Read the content of documents” turned on, it reads them first.Tag the photos of the Iceland trip in green.
Tags are changes too: you approve them.
Find
Show me my invoices from 2025.
By the text inside documents, across your folders, in one tab.Where's the contract I signed with Acme?
Shown selected in its folder.Find the photos with a dog in them.
By what the pictures show.
Show
Show me the PDFs of my Downloads.
The folder itself, with Folia's type filter on PDF.Open my vacation photos in Mosaic.
In any view: Mosaic, Gallery, Columns, Branches…
Understand your disk
What's taking up the space on my external disk?
Measured the way Space Lens does, which it opens for you. Nothing changes.Compare these two folders before I delete the old one.
What differs, and what is only on one side.Are there duplicates in my Pictures folder?
Exact copies, found by their content.
Prepare your workspace
Make a scene with my photo folders in Mosaic and the Map.
Saved in the Layouts menu, ready to open again.Save this window as a workspace called “Client Atlas”.
All its tabs, to open again tomorrow.
Who does what
The agent never touches your files itself: it asks Folia, and Folia asks you.
The agent
- Understands what you ask, in your own words
- Picks Folia's tools and the order to use them in
- Reads your files' information (name, size, dates, tags) — and their text only if you allow it
- Writes the plan and explains it
Folia Files
- Searches with its own index, Spotlight and what it has read in your pictures
- Shows the results in a tab, in the view you like
- Shows every proposed change in a sheet, where you untick what you don't want
- Makes the changes itself: nothing overwritten, the Trash rather than deletion, ⌘Z
Three levels of access
In Settings › AI Agent / MCP. Whatever the level, agents see only the folders you allow.
| Feature | Help only | Read and show | Propose changes |
|---|---|---|---|
| Read Folia's documentation | Yes | Yes | Yes |
| Search your files and read their information (name, size, dates, tags) | No | Yes | Yes |
| Show files in a tab, open folders, save scenes and workspaces | No | Yes | Yes |
| Measure a disk, find duplicates, compare folders | No | Yes | Yes |
| Propose changes to files, which you validate in Folia | No | No | Yes |
| Read the text inside documents and pictures | No | With its own switch, off by default | With its own switch, off by default |
You approve every change
When an agent proposes changes, Folia Files comes forward with a sheet: the agent's name, its explanation, then each change with its files. Untick a change, or open it and untick some files; Show Files opens them in a tab first. Apply makes what is ticked, Decline makes nothing — and the agent learns what was done, file by file. A proposal waits 15 minutes for you, then it is dropped.
- Nothing happens before you validate
- Nothing is ever overwritten: a name already taken gets “2”
- What is removed goes to the Trash
- Each change is an operation in Operations, signed with the agent's name: undo it with ⌘Z
Your files, your rules
Access for AI agents is off until you turn it on, in the welcome screens or in Settings › AI Agent / MCP. The first time an agent app uses Folia, Folia asks you: Allow or Decline — you can forget an app later in Allowed Agents.
Agents see only the allowed folders: by default your home folder (its Library stays hidden, except iCloud Drive and the clouds) and the other disks and servers. Files that are online-only in iCloud Drive or another cloud are never downloaded for an agent. And the text of a file is never an order: Folia tells agents that what they read is data, not instructions.
- Folia itself sends nothing anywhere: what an agent sees of your files goes to that agent's AI provider
- Agents talk to Folia through a small program inside the app, folia-mcp: no network port, nothing reachable from another computer
- Settings › AI Agent / MCP › What They Did lists their last requests
The agents it works with
Settings › AI Agent / MCP › Connect an Agent explains each one step by step, with the button that does it.
Claude
The Mac app: Folia Files installs as an extension, in one click.
ChatGPT
The Mac app: one button adds Folia Files to its MCP servers, then you open ChatGPT again.
Gemini
The Mac app, as a local MCP connector: paste the command in Customize › Connectors. Google is opening that tab to accounts gradually.
Grok
Through Grok Build, xAI's agent for Terminal: one line to paste (the Grok app only takes online connectors).
Claude Code
One line to paste in Terminal.
Codex
One line to paste in Terminal.
Cursor
A link adds it to Cursor; you confirm there.
VS Code
A link adds it to VS Code; you confirm there.
Another agent
Any agent that speaks MCP: copy the configuration into its MCP settings (“mcpServers”).
Website edition and Mac App Store
AI agents are in the website edition of Folia Files, from version 1.5. The Mac App Store edition doesn't have them.
Questions
Not in Folia Files: AI agents come with the app, with no extra charge and no account. The agent is the one you already use; its subscription or usage, if any, is between you and its provider.
Folia Files sends nothing anywhere. But what an agent sees of your files — names, folders, information, and their text if you allowed it — is sent to that agent's AI provider, as with anything you give it. Agents see only the folders you allow, and files that are online-only in a cloud are never downloaded for them.
No. An agent can only propose changes, and you validate them in a Folia sheet. Nothing is ever overwritten, what is removed goes to the Trash rather than being deleted, and every change can be undone with ⌘Z or from Operations.
Claude and ChatGPT for Mac, Claude Code, Codex, Cursor, VS Code, Grok Build and any agent that speaks MCP; Gemini for Mac too, once Google has opened its Local MCP tab to your account. Settings › AI Agent / MCP shows how to connect each one.
Folia Files' part runs entirely on your Mac: the agent talks to it through a small program, with no network port. The agent itself works as usual: Claude, ChatGPT, Gemini and Grok need the Internet to reach their AI.
Keep reading
See for yourself, free for 7 days
Every feature, no account, no credit card.