Connect Cloudflare R2 to Your AI Agent

Prepare an object inventory or retrieve a known file for a handoff.

40 tools Custom credential / OAuth

Try a Cloudflare R2 Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Cloudflare R2

Prepare a bucket object inventory

List files under a chosen bucket prefix and organize their metadata.

/oo Cloudflare R2: Find Cloudflare R2 bucket [name] and list all object pages under prefix [prefix]. Prepare an inventory with object keys and metadata present, grouped by prefix. Keep folder-like prefixes distinct from file objects and summarize the listed scope.

Retrieve or place a specified file

Move an explicit file between a bucket and the intended handoff location.

/oo Cloudflare R2: Download Cloudflare R2 object [object key] from bucket [bucket] as filename [name] and provide its transfer link. If I explicitly supply an upload, place source [accessible URL or supplied text] at key [destination key] in bucket [bucket], with content type [type]. Report the exact bucket and key used.

Start Working with Cloudflare R2

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect Cloudflare R2

Connect through Cloudflare authorization or supply an API token and account ID.
Connect Cloudflare R2 →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

Grant access to the intended account, buckets and object operations.
Use the correct bucket jurisdiction when applicable. Downloads are delivered through a temporary transfer file.

Cloudflare R2 Tools

Read Cloudflare R2 buckets, objects and bucket policies. Object download and upload operations support file handoffs, while bucket configuration operations let you inspect and apply explicitly chosen settings.

Buckets and files

Read bucket inventories, list objects and transfer specified files.

Bucket policy review

Inspect cross-origin, lifecycle, lock and domain settings.

40 tools

List Accounts

List Cloudflare accounts visible to the current credential.

cloudflare_r2.list_accounts

List Buckets

List the R2 buckets in a Cloudflare account.

cloudflare_r2.list_buckets

Get Bucket

Get one R2 bucket by name.

cloudflare_r2.get_bucket

Download Object

Download one R2 object and upload it to connector transit storage.

cloudflare_r2.download_object

Create Bucket

Create an R2 bucket in a Cloudflare account.

cloudflare_r2.create_bucket

Update Bucket

Update mutable R2 bucket properties such as default storage class or jurisdiction.

cloudflare_r2.update_bucket

Delete Bucket

Delete an R2 bucket by name.

cloudflare_r2.delete_bucket

Get Bucket Cors Policy

Fetch the bucket-level CORS policy for an R2 bucket.

cloudflare_r2.get_bucket_cors_policy

Update Bucket Cors Policy

Replace the bucket-level CORS policy for an R2 bucket.

cloudflare_r2.update_bucket_cors_policy

Delete Bucket Cors Policy

Delete the bucket-level CORS policy for an R2 bucket.

cloudflare_r2.delete_bucket_cors_policy

Put Object

Upload one R2 object from a public URL, plain text, or base64-encoded content.

cloudflare_r2.put_object

Generate Presigned Url

Generate a pre-signed R2 URL for one GET, PUT, or HEAD request using a custom API token credential.

cloudflare_r2.generate_presigned_url

List Objects

List objects in an R2 bucket with optional prefix, delimiter grouping, and cursor pagination.

cloudflare_r2.list_objects

Delete Object

Delete one R2 object by key.

cloudflare_r2.delete_object

Delete Objects

Delete a list of R2 objects by key in one request.

cloudflare_r2.delete_objects

Delete Objects By Prefix

Start a background job that deletes every object under a key prefix, or empties the whole bucket.

cloudflare_r2.delete_objects_by_prefix

List Bucket Jobs

List background jobs for an R2 bucket, such as prefix delete jobs.

cloudflare_r2.list_bucket_jobs

Get Bucket Job

Get the current status of one R2 bucket background job.

cloudflare_r2.get_bucket_job

List Custom Domains

List the custom domains attached to an R2 bucket.

cloudflare_r2.list_custom_domains

Get Custom Domain

Get the settings of one custom domain attached to an R2 bucket.

cloudflare_r2.get_custom_domain

Add Custom Domain

Attach a custom domain from a Cloudflare zone to an R2 bucket.

cloudflare_r2.add_custom_domain

Update Custom Domain

Update the public access, TLS version, or cipher settings of a custom domain.

cloudflare_r2.update_custom_domain

Delete Custom Domain

Detach a custom domain from an R2 bucket.

cloudflare_r2.delete_custom_domain

Get Managed Domain

Get the r2.dev managed domain and its public access state for an R2 bucket.

cloudflare_r2.get_managed_domain

Update Managed Domain

Enable or disable public access to an R2 bucket through its r2.dev domain.

cloudflare_r2.update_managed_domain

Get Bucket Lifecycle

Get the object lifecycle rules of an R2 bucket.

cloudflare_r2.get_bucket_lifecycle

Update Bucket Lifecycle

Replace the object lifecycle rules of an R2 bucket with the given rule set.

cloudflare_r2.update_bucket_lifecycle

Get Bucket Lock

Get the object lock rules of an R2 bucket.

cloudflare_r2.get_bucket_lock

Update Bucket Lock

Replace the object lock rules of an R2 bucket with the given rule set.

cloudflare_r2.update_bucket_lock

Get Bucket Local Uploads

Get whether local uploads are enabled, which writes objects to the nearest region before replicating to the primary region.

cloudflare_r2.get_bucket_local_uploads

Update Bucket Local Uploads

Enable or disable local uploads for an R2 bucket.

cloudflare_r2.update_bucket_local_uploads

Get Sippy Config

Get the Sippy incremental migration configuration of an R2 bucket.

cloudflare_r2.get_sippy_config

Enable Sippy

Enable Sippy so that objects missing from the R2 bucket are copied on demand from a source bucket on AWS S3, Google Cloud Storage, an S3-compatible service, or Azure Blob Storage.

cloudflare_r2.enable_sippy

Disable Sippy

Disable Sippy on an R2 bucket.

cloudflare_r2.disable_sippy

List Event Notification Rules

List every event notification rule of an R2 bucket grouped by target queue.

cloudflare_r2.list_event_notification_rules

Get Event Notification Rules

Get the event notification rules that send R2 bucket events to one queue.

cloudflare_r2.get_event_notification_rules

Create Event Notification Rules

Add event notification rules that send R2 bucket events to a Cloudflare Queue.

cloudflare_r2.create_event_notification_rules

Delete Event Notification Rules

Delete event notification rules bound to one queue. Deletes every rule for the queue when ruleIds is omitted.

cloudflare_r2.delete_event_notification_rules

Get Account Metrics

Get object count and storage usage metrics across all R2 buckets in the account. Metrics may lag behind the latest data.

cloudflare_r2.get_account_metrics

Create Temporary Access Credentials

Create short-lived S3-compatible credentials scoped to one R2 bucket and optionally to prefixes or objects.

cloudflare_r2.create_temporary_access_credentials

Frequently Asked Questions

How do I limit an inventory to one folder?

Supply the bucket name and object-key prefix. A prefix is a key filter rather than a separate filesystem directory; use the delimiter option when you want grouped prefixes.

Can I review how old objects are retained?

Read lifecycle and lock rules for the bucket. They describe configured rules; an object inventory can help identify what those rules might cover without changing them.

What information is needed to retrieve a file?

Provide the exact bucket name and object key, plus jurisdiction when applicable. The download produces a temporary transfer link for the selected file.