Just ask in plain language
The MCP server is available in Owlfiles for macOS. It lets an AI agent — such as Claude Desktop, Claude Code, or Codex — access the files in Owlfiles. Once connected, simply ask:
“List the files in my Google Drive”
“Copy report.pdf from my NAS to Dropbox”
“Find every invoice from last month on my SMB server”
The agent uses Owlfiles to fulfil the request across local disk, SMB, FTP, SFTP, WebDAV, NFS, and your cloud drives. Because copy and move work across connections, you can ask it to transfer files directly between your NAS and a cloud drive.
What the agent can do
The Owlfiles MCP server exposes these tools to your AI agent.
list_connections— list all of your configured Owlfiles connections.list_dir— list the contents of a folder.get_item_metadata— get the size, type, and modified date of a file or folder.search_files— search for files and folders by name keyword.read_file— read the contents of a file; large files are read in chunks.write_file— create or overwrite a file; large files upload in chunks.create_folder— create a new folder.copy_item— copy a file or folder, including between two connections.move_item— move or rename a file or folder, including across connections.delete_item— delete a file or folder.
Works with your favourite AI agent
Open Settings → MCP (AI Plugin) in Owlfiles. Claude Desktop, Claude Code, and Codex can install the plugin with a single click; any other MCP-compatible tool can be added manually.
The server type is stdio. Add this entry to the tool’s MCP configuration and restart the agent:
{
"mcpServers": {
"owlfiles": {
"command": "/Applications/Owlfiles.app/Contents/MacOS/Owlfiles",
"args": ["--mcp"]
}
}
}Private and secure by design
The MCP server runs on your Mac and reuses Owlfiles’ own connections and saved credentials.
Stays on your machine
The server runs locally and is launched by your AI agent only when needed. It is not a network service and opens no port. No passwords or tokens are sent to the agent — only the file data needed to fulfil a request.
Sandbox respected
Owlfiles runs in the macOS App Sandbox. For files on your local disk, the agent can only reach folders you have already opened once in the Owlfiles app. Remote and cloud connections are fully available.