Connect S3-compatible storage to Claude Code

Read one bucket on any S3-compatible object store. Hetzner, Cloudflare R2, MinIO, Wasabi or AWS, by listing its objects and reading small JSON files. Add Toolspoke to Claude Code once and it can use 2 S3-compatible storage actions. Your S3-compatible storage credential stays in Toolspoke, and you choose which actions Claude Code may call.

Set it up in Claude Code

Three steps, the first one once for every toolkit you will ever add.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. Install S3-compatible storage and connect it

    Add S3-compatible storage to a project in your Toolspoke workspace.

    Access keys. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.

    Endpoint URL
    The store's S3 endpoint, without the bucket. Hetzner is https://<location>.your-objectstorage.com; R2 is https://<account>.r2.cloudflarestorage.com.
    Bucket
    The one bucket this install may read. Calls are path-style, so the bucket is the first path segment.
    Access key
    Secret key
  3. Choose what Claude Code may do

    All 2 actions only read, and any of them can be switched off for a project.

What you can ask Claude Code for

A few of the S3-compatible storage actions that only read, so they are safe to try first.

  • List objects in the bucket, optionally under a prefix, up to 1000 per page
  • Read one JSON object from the bucket, such as a status marker or a manifest, and return it parsed

What Claude Code can do in S3-compatible storage

2 actions read.

Reads

  • List objects

    List objects in the bucket, optionally under a prefix, up to 1000 per page. Returns objects (key, lastModified, size), prefixes (the directories a delimiter groups keys into), truncated, and nextContinuationToken when there is another page, pass it back as continuation_token. With delimiter "/" and a prefix ending in "/", list one directory level.

  • Get json object

    Read one JSON object from the bucket, such as a status marker or a manifest, and return it parsed. At most the first 256 KB is read, so a large object cannot be pulled through here.

S3-compatible storage in Claude Code: questions

Does Claude Code see my S3-compatible storage credential?

No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.

Will 2 actions crowd Claude Code's context?

No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the S3-compatible storage action it needs when it needs it. Adding more toolkits does not add more tools to its list.

Can I add it once for every project?

Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.

What does it cost?

Tool calls are free on every plan, and a S3-compatible storage call does not run in a sandbox, so it bills nothing.

Try S3-compatible storage in Claude Code

Free to start, and tool calls cost nothing on any plan.