MCP server

Connect an AI agent to CloudRoam

The CloudRoam MCP server lets Claude, or any MCP-capable agent, run your backups, connect clouds, create shares, and organize files for you. It is one small file with no dependencies. Your files are never read by the agent; it only calls the same API the web app uses, with a key you can revoke any time.

Download cloudroam-mcp.mjs

Setup in three steps

Create an API key

In CloudRoam, open your account menu, Account Settings, API keys, and click Create API key. Copy it once, it looks like crk_....

Download the server

Save cloudroam-mcp.mjs somewhere on your machine. You need Node 18 or newer.

Point your agent at it

Add it to your MCP client with two environment variables. Claude Desktop, in claude_desktop_config.json:

{
  "mcpServers": {
    "cloudroam": {
      "command": "node",
      "args": ["/absolute/path/to/cloudroam-mcp.mjs"],
      "env": {
        "CLOUDROAM_API_KEY": "crk_your_key_here",
        "CLOUDROAM_BASE_URL": "https://cloudroam.io"
      }
    }
  }
}

Claude Code, from a terminal:

CLOUDROAM_API_KEY=crk_your_key_here \
claude mcp add cloudroam -- node /absolute/path/to/cloudroam-mcp.mjs

Restart your agent after adding the server. Ask it "what CloudRoam tools do you have?" to confirm the connection.

What the agent can do

list_connectors

See the clouds on your account.

create_connector

Connect S3, S3-compatible, Azure, SFTP, WebDAV or SMB with keys.

create_multicloud

Mirror one folder across 2 to 4 clouds at once.

create_backup_schedule

Mirror, copy or move a folder between clouds on an interval.

run_backup_schedule

Run a backup right now.

get_backup_log

When it last ran, how many files, size, status.

list_backup_schedules

Every schedule and its last run.

list_files

Browse a bucket or folder.

move_file

Sort files into folders, rename, reorganize.

create_file_share

A public link to one file, with expiry and password.

create_folder_share

A public link to a whole folder, upload optional.

list_shares

All active share links.

revoke_share

Kill a link immediately.

Try it

Once connected, just talk to your agent in plain language:

Connect my AWS account. Access key AKIA..., secret ...,
region eu-west-1, name it "Company S3".

Back up the invoices folder on Company S3 to my OneDrive
every night, keep the originals.

Run all over my documents in the "office" bucket and sort
them into folders by type: Invoice, Letter, Contract,
Receipt, and anything else you think fits.

Share the 2025 audit folder with a 7 day link and a password,
and send me the URL.

Security: the key authorizes the account, not your cloud passwords. Storing keys through the agent puts them in CloudRoam's encrypted server store. The agent never sees file contents, and you can disable or revoke the key from Account Settings at any moment.