MCP tools

drive_lsList folder

List a folder. `/` lists the mounts (one per storage location) with what this connection may do in each. Returns names, sizes, modified times and ETags. Use `recursive` for every file below a folder, and `cursor` to page through large folders.

drive_readRead file

Read a file. Text comes back with line numbers; use `offset` (first line, 1-based) and `limit` (line count) for long files, or byteOffset/byteLength for exact bytes. Images up to 2 MiB come back as images. Other binary files return metadata; use drive_transfer to download them. The result includes the file's ETag for conditional writes.

drive_searchSearch files

Find files by name and/or search inside them. `name` is a glob on the file name (e.g. `*.md`, `report-??.csv`); `content` is a regular expression matched line by line in text files. Results are bounded; narrow `path` for large drives.

drive_writeWrite file

Create or replace a file. Pass `ifMatch` with the ETag from drive_read to replace only the version you read (if someone changed it since, the write is refused); pass `createOnly` to never replace an existing file. Use `encoding: base64` for binary. For files over a few MB, use drive_transfer upload links instead.

drive_editEdit file

Replace exact text in a text file. Each `oldText` must match exactly once (include surrounding lines to make it unique) unless `replaceAll` is set. The edit applies only to the version it read, so concurrent changes are never lost; pass `ifMatch` to require a specific ETag.

drive_filesCopy, move, delete

Copy, move or delete files and folders, or make a folder, across any mounts, like cp/mv/rm/mkdir. Copies between locations on the same storage account happen server-side; across providers they stream directly between them. A destination ending in `/` or an existing folder receives the item inside it. Folders need `recursive`. Mount points themselves cannot be deleted. Big trees continue as a background job.

drive_transferTransfer links

Move bytes without passing them through this conversation. `download` returns a time-limited GET link for a file; `upload` returns a PUT link that accepts one upload (create-only connections get links that cannot replace files); `multipart` starts a large upload (one PUT link per part, then call `complete` with each part's ETag header). Fetch the links with curl or any HTTP client in your environment.

drive_shShell

Run bash over this drive. Each mount is a top-level folder, so `cp -r /aws-bucket/folder /r2-bucket/somefolder` copies across providers. Supports pipes, redirection, globbing, loops and common tools: ls, cat, head, tail, grep, rg, find, sed, awk, jq, sort, uniq, wc, cut, tr, xargs, diff, gzip, base64, sha256sum and more. Drive commands: `mounts`, `url PATH` (download link), `upload-url PATH`, `info PATH`. /tmp is scratch for this command only. No network access and no programs beyond these. Writes are saved when the command finishes.

drive_codeRun code

Run an async JavaScript function next to the data, for multi-step work: loops, filtering, transforming files, bulk edits, decisions based on earlier results. It runs isolated with no network; the only capability is this drive API (also available as bare globals like ls(), cat(), cp(), write(), sh()). Return a JSON-serializable value (at most 64,000 characters); console.log output is returned too. Up to 45 seconds and 1,000 drive calls per run. Copies, moves and deletes that need longer continue as background jobs (see drive_jobs).

The full API it can call is on the Code Mode page.

drive_jobsBackground jobs

List background jobs (large copies, moves and deletes that continue after a tool call returns), check one by `id`, or cancel it.

drive_activityRecent activity

Recent changes in this drive: who wrote, copied, moved or deleted what, and when. Use it to pick up where another agent or person left off. Filter by `path` prefix.

drive_manageManage drive

Configure this drive (allowed because the owner granted management). Actions: `list_storage` (saved storage connections); `request_storage` (create a one-time link where a person, or you with curl and environment variables, enters an access key and secret for a new S3-compatible bucket; the secret never passes through this conversation; give name, provider, bucket and optionally prefix, region/accountId/endpoint, path and access); `add_mount` (mount a bucket folder from an existing connection at a path); `remove_mount` (by path); `set_description` (the instructions agents see). Providers: r2, aws, minio, b2, wasabi, gcs, spaces, tigris, hetzner, scaleway, linode, vultr, supabase, storj, oracle, custom. Access presets: read-only, contribute, read-write, full, drop-box.