Log inSubmit server
Rclone logo

Rclone

Connects AI assistants to rclone's RC API for cloud storage management, file operations, synchronization, and configurable read-only access.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Rclone

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "rclone": {
      "command": "npx",
      "args": [
        "-y",
        "rclone-mcp"
      ],
      "env": {
        "RCLONE_URL": "YOUR_VALUE_HERE",
        "RCLONE_USER": "YOUR_VALUE_HERE",
        "RCLONE_PASS": "YOUR_VALUE_HERE",
        "RCLONE_TOOLSETS": "YOUR_VALUE_HERE",
        "RCLONE_READ_ONLY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y rclone-mcp

Method not found

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 7d ago.

Overview

The rclone MCP server exposes rclone's Remote Control API to AI assistants through generated MCP tools. It supports cloud storage remote management, directory listing, file copying, synchronization, and other rclone operations. Run it over stdio for Cursor or Claude Desktop, or use Streamable HTTP for remote and web-based clients. Choose toolsets and enable read-only mode to limit the available operations.

Use cases

  • Manage rclone cloud storage remotes through an AI assistant
  • List directories and inspect files across configured remotes
  • Copy, move, delete, or synchronize files with selected operations enabled
  • Expose read-only storage access for safer assistant workflows
  • Run rclone controls remotely through Streamable HTTP

Key features

  • Generated tools for 98 rclone RC API endpoints
  • Selectable toolsets with default and all presets
  • Stdio and Streamable HTTP transports
  • Read-only mode for non-mutating access
  • Optional HTTP Basic Auth for the rclone daemon
  • Docker and npx installation paths

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

8/8 checks healthy over the last 50d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 17d ago via OSV.dev · rclone-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars13Stargazers on the source repository.
npm downloads268Package downloads in the last 30 days.
Last commit8mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Rclone works

What the rclone MCP server does

The rclone MCP server connects MCP-compatible AI assistants to a running rclone Remote Control (RC) daemon. It turns the RC API into MCP tools that an assistant can call for cloud storage administration and file operations. Supported tasks include managing remotes, listing directories, copying and synchronizing files, and accessing additional rclone API areas when their toolsets are enabled.

The implementation generates its tools from the rclone OpenAPI specification and uses the rclone SDK client. The API contains 98 endpoints in total, although the default configuration exposes 55 tools from four toolsets. This makes the rclone MCP server suitable when an assistant needs structured access to an existing rclone setup rather than direct filesystem-only operations.

How it works

First, start the rclone RC daemon. It can run without authentication or with an HTTP Basic Auth username and password. The MCP process then sends requests to the daemon at the configured URL and presents the corresponding capabilities to the connected assistant.

The server supports two transports. Stdio is the default and is appropriate for local MCP client configurations. Streamable HTTP can be started on a selected port for remote hosting or web-based MCP clients. Toolsets are grouped by API path, so the exposed tool list can be kept focused instead of enabling every endpoint.

Setup and configuration

Install and run the package with npx rclone-mcp, or build and run the supplied Docker image. Set RCLONE_URL when the RC daemon is not at its default address of http://localhost:5572. For an authenticated daemon, provide RCLONE_USER and RCLONE_PASS.

Use RCLONE_TOOLSETS or --toolsets with comma-separated values such as operations,config. The default value enables core, config, operations, and sync; all enables every listed toolset. Start the HTTP transport with rclone-mcp http --port 3000. The server can be added to Cursor or Claude Desktop as a stdio MCP entry.

Tools and capabilities

Default toolsets cover core and RC endpoints, configuration, operations, and synchronization. Optional groups add jobs, VFS, mounts, serving, cache, debugging, backend operations, options, plugins, and filesystem cache functions. The exact tools available depend on the selected groups.

Read-only mode is enabled with --read-only or RCLONE_READ_ONLY=1. It registers only non-mutating tools, excluding actions such as copying, moving, deleting, synchronizing, creating configuration, mounting, and unmounting. This mode is useful when an assistant should inspect storage without changing it.

Limitations and notes

The rclone MCP server requires a running rclone RC daemon; it does not replace that daemon or configure its underlying storage providers by itself. Write-capable toolsets can perform destructive or state-changing operations, so read-only mode should be considered when changes are not intended. Optional toolsets are disabled by default, and enabling all exposes a larger set of 98 endpoint-backed tools.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Rclone

rclone is an MCP server that connects AI assistants to the rclone Remote Control API. Its main tools manage cloud storage remotes, list directories, copy and synchronize files, and access other selectable rclone API toolsets. It requires a running rclone RC daemon and supports stdio or Streamable HTTP transport.

Install it with `npx rclone-mcp` and configure an MCP client to launch that command. Set `RCLONE_URL` if the RC daemon is not on its default address, and add `RCLONE_USER` and `RCLONE_PASS` when the daemon requires authentication. Docker is also supported.

Yes, rclone works with Cursor through stdio transport. Add an `rclone` entry to `.cursor/mcp.json`, use `npx` with the `rclone-mcp` package, and set the RC daemon URL in the environment.

Start it with `--read-only` or set `RCLONE_READ_ONLY=1`. Only non-mutating tools are then registered, while operations such as copying, deleting, syncing, configuration creation, mounting, and unmounting are excluded.

Pass a comma-separated list with `--toolsets` or `RCLONE_TOOLSETS`. The default includes core, config, operations, and sync; `all` enables every toolset. Optional groups include jobs, VFS, mount, serve, cache, debug, backend, options, plugins, and fscache.

Related MCP servers

All in File Systems All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRclone AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/rclone?style=directory)](https://allmcps.com/mcp/rclone)
HTML Embed
<a href="https://allmcps.com/mcp/rclone"><img src="https://allmcps.com/api/badge/rclone?style=directory" alt="Rclone on AllMCPs" /></a>