SkillFoxx

Timeweb Cloud S3 MCP and CLI: backup size and archives

timeweb-s3-mcp-ai-cli

The timeweb-s3 binary connects Claude Code, Cursor and Codex to Timeweb Cloud S3: prefix size, archive recovery, rights by level

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • S3 keys let the agent read bucket objects, and permissions for writing, deletion and configuration add changes to the storage
  • A temporary link exposes an object to anyone who knows the address
All reasons and checks
Russian stack

stufently/timeweb-s3-mcp-ai-cliAuthor:stufently

Install

Manual install

timeweb-s3 mcp install --client cursor

First the binary from releases and `timeweb-s3 auth set`; other clients take another `--client` value.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • S3 keys let the agent read bucket objects, and permissions for writing, deletion and configuration add changes to the storage
  • A temporary link exposes an object to anyone who knows the address

This is third-party code. Review the repository files before installing.

What it does

The `timeweb-s3` program in Go serves Timeweb Cloud S3 in three roles: an MCP server, a command line and a skill. The agent looks into buckets, counts backup size by prefix, downloads archives and issues temporary links; versions, CORS, policy and the Object Lock configuration are available where the cloud supports them. The capability profile separates the S3 API connection from bucket plan selection: the `standard`, `hot` and `cold` classes describe the plan catalog and do not change the object StorageClass header. Writing, deletion and administration open with the `TIMEWEB_S3_ALLOW` variable, for example `write,delete`. The `timeweb-s3 mcp install` installer registers the server in Codex, Claude Code, Claude Desktop and Cursor.

Who it is for. Owners of sites and services on Timeweb Cloud who keep backups in S3 and go through them with an agent.

Good fit when

  • Backups grow and you need to see which prefix takes the most space
  • A site is down and you need the last archive from a bucket
  • A contractor needs a temporary link to an archive
  • The MCP configuration must reach Cursor or Codex with one command

Not a fit when

  • A `cold` or `premium` bucket is created in the Timeweb panel: the `mb` command takes the default class
  • You need to change Object Lock: PUT of this configuration is disabled until confirmed
  • The storage is outside Timeweb: the same author has separate projects for Selectel, VK Cloud and other clouds

Example request

Show which prefixes in the backups bucket take the most space and find the latest site archive

MCP

Transport
stdio
Authentication
API key

Environment variables

TIMEWEB_S3_ACCESS_KEY_ID required
Timeweb Cloud S3 key id
TIMEWEB_S3_SECRET_ACCESS_KEY required, secret
S3 secret key
TIMEWEB_S3_POOL
Pool, `ru-1` by default
TIMEWEB_S3_ALLOW
Rights levels: `write`, `delete`, `admin`

Limitations

The only release, 0.1.0, is in development status and is published in Smithery and the MCP registry. Installation: a ready binary from releases, a build with Go 1.27.2 or a Docker container. Timeweb Cloud S3 keys are required, the default pool is `ru-1`; the secret must not be passed in arguments. A price of 0 in the profile means an unknown per-GB rate. Until writing, deletion or admin rights are enabled explicitly, the server reads data and changes nothing. An HTTP endpoint needs the `TIMEWEB_S3_ALLOW_INSECURE=1` variable.

How to disable. Remove `timeweb-s3` from the client configuration together with the local credentials file and revoke the S3 keys in the Timeweb Cloud panel.

FAQ

How do I connect Timeweb S3 to Codex?

With `timeweb-s3 mcp install --client codex`; the block between the `timeweb-s3 (managed)` markers in `~/.codex/config.toml` is replaced only with `--force`.

How do I create a cold-class bucket?

In the Timeweb panel: the `mb` command creates a bucket with the default class, while cold and premium are chosen at creation in the panel.

Can only downloading be allowed?

Yes: without `--allow-*` flags reading is available, and downloading to a file is enabled with the `TIMEWEB_S3_FILE_ROOT` directory.

What does `timeweb-s3 mcp install` do?

It writes the MCP configuration to the chosen client; `--dry-run` shows changes without writing, and Claude Code has the `--scope project` and `--scope user` scopes.

How do I estimate backup size?

The `s3_prefix_usage` and `s3_largest_objects` tools count size by prefix and find large objects within a bounded scan.

Discussion

No questions or reviews yet.

All Timeweb Cloud tools
Russian stack

An MCP server with full Timeweb Cloud API coverage: servers, databases, Kubernetes, S3, domains and DNS, SSH keys, floating IPs and billing

MCP serverBroad access
Official

Timeweb Cloud's official remote MCP: account servers, databases, Kubernetes, domains, mail, S3 and billing, with mandatory confirmation for changes

MCP serverBroad access26
Russian stack

A broad Timeweb Cloud MCP server: 245 tools across servers, Kubernetes, databases, S3, domains, mail and billing

MCP serverBroad access
Russian stack

Lightweight MCP for domains and DNS records of classic Timeweb hosting, requires two-factor authentication disabled on the account

MCP serverBroad access
Russian stack

A Claude plugin for Timeweb Cloud: servers, domains, DNS and balance, with dangerous operations gated by explicit confirmation and name checks

PluginBroad access

Timeweb Cloud domains MCP

timeweb-cloud-mcp-server

Russian stack

An MCP for the Timeweb Cloud API: domains, subdomains, DNS records, name servers and the full domain registration, renewal and transfer flow

MCP serverBroad access

README in short

The bilingual documentation goes from a quick start through the binary and Docker to an install button for Cursor and commands for other clients, then a table of tools by rights level and a scenario for restoring archives with prefix size accounting.

README badge

Report a problem