English Français العربية

io.github.rclone-ui/rclone

Official registry Other

MCP server for the Rclone RC API, with selectable toolsets.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package rclone-mcp
Claude Code 
claude mcp add rclone -e 'RCLONE_URL=<RCLONE_URL>' -e 'RCLONE_USER=<RCLONE_USER>' -e 'RCLONE_PASS=<your rclone_pass>' -e 'RCLONE_TOOLSETS=<RCLONE_TOOLSETS>' -e 'RCLONE_READ_ONLY=<RCLONE_READ_ONLY>' -e 'RCLONE_MCP_MAX_OUTPUT=<RCLONE_MCP_MAX_OUTPUT>' -- npx -y rclone-mcp@2.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "rclone": {
            "command": "npx",
            "args": [
                "-y",
                "rclone-mcp@2.0.0"
            ],
            "env": {
                "RCLONE_URL": "<RCLONE_URL>",
                "RCLONE_USER": "<RCLONE_USER>",
                "RCLONE_PASS": "<your rclone_pass>",
                "RCLONE_TOOLSETS": "<RCLONE_TOOLSETS>",
                "RCLONE_READ_ONLY": "<RCLONE_READ_ONLY>",
                "RCLONE_MCP_MAX_OUTPUT": "<RCLONE_MCP_MAX_OUTPUT>"
            }
        }
    }
}

Environment variables

  • RCLONE_URL A running rclone to use. Without it, rclone-mcp starts its own
  • RCLONE_USER HTTP Basic Auth username for RCLONE_URL
  • RCLONE_PASS secret HTTP Basic Auth password for RCLONE_URL
  • RCLONE_TOOLSETS Comma-separated list of toolsets to enable (default, all, or specific: core, config, operations, sync, jobs, vfs, mount, dangerous, etc.)
  • RCLONE_READ_ONLY Set to 1 to expose only tools that change nothing and return no credentials
  • RCLONE_MCP_MAX_OUTPUT The most characters of output a tool call returns. Defaults to 100000

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. rclone-mcp
  2. Prerequisites
  3. Installation
  4. Configuration
  5. Toolsets
  6. Read-Only Mode
  7. License

rclone-mcp

MCP (Model Context Protocol) server for the Rclone RC API. Gives AI assistants the ability to manage cloud storage remotes, copy/sync files, list directories, and more — all through natural language.

Tools are auto-generated from the rclone-openapi spec using the rclone-sdk client. 98 endpoints, organized into selectable toolsets.

Prerequisites

A running rclone remote control daemon:

rclone rcd --rc-no-auth
# or with auth:
rclone rcd --rc-user=admin --rc-pass=secret

Installation

Cursor / Claude Desktop (stdio)

Add to your .cursor/mcp.json or claude_desktop_config.json:

{
  "mcpServers": {
    "rclone": {
      "command": "npx",
      "args": ["-y", "rclone-mcp"],
      "env": {
        "RCLONE_URL": "http://localhost:5572"
      }
    }
  }
}
With authentication
{
  "mcpServers": {
    "rclone": {
      "command": "npx",
      "args": ["-y", "rclone-mcp"],
      "env": {
        "RCLONE_URL": "http://localhost:5572",
        "RCLONE_USER": "admin",
        "RCLONE_PASS": "secret"
      }
    }
  }
}
Docker
docker build -t rclone-mcp .

docker run -i --rm \
  -e RCLONE_URL=http://host.docker.internal:5572 \
  rclone-mcp
Streamable HTTP transport

For remote hosting or web-based MCP clients:

npx rclone-mcp http --port 3000

Configuration

Environment Variables
VariableDescriptionDefault
RCLONE_URLrclone RC daemon URLhttp://localhost:5572
RCLONE_USERHTTP Basic Auth username—
RCLONE_PASSHTTP Basic Auth password—
RCLONE_TOOLSETSComma-separated toolset listdefault
RCLONE_READ_ONLYSet to 1 to disable write tools—
CLI Arguments
rclone-mcp [command]

Commands:
  rclone-mcp stdio  Run with stdio transport (default)
  rclone-mcp http   Run with Streamable HTTP transport

Options:
  --toolsets   Comma-separated list of toolsets
  --read-only  Only expose read-only tools
  --port       HTTP port (http command only, default: 3000)

Toolsets

Tools are grouped by API path prefix. Enable only what you need to keep the tool list focused.

ToolsetPathsDefault
core/core/*, /rc/*Yes
config/config/*Yes
operations/operations/*Yes
sync/sync/*Yes
jobs/job/*No
vfs/vfs/*No
mount/mount/*No
serve/serve/*No
cache/cache/*No
debug/debug/*No
backend/backend/*No
options/options/*No
plugins/pluginsctl/*No
fscache/fscache/*No

Special values:

  • default — the four default toolsets (core, config, operations, sync)
  • all — every toolset
Examples
# Default toolsets (55 tools)
npx rclone-mcp

# Everything (98 tools)
RCLONE_TOOLSETS=all npx rclone-mcp

# Just file operations and config
npx rclone-mcp --toolsets operations,config

# Default + mount
npx rclone-mcp --toolsets default,mount

# Read-only mode (no copy, delete, sync, etc.)
npx rclone-mcp --read-only

Read-Only Mode

When --read-only or RCLONE_READ_ONLY=1 is set, only non-mutating tools are registered. This excludes operations like file copy/move/delete, sync, config creation, mount/unmount, etc. Useful for giving AI assistants safe, read-only access.

License

MIT

Made with ☁️ for the rclone community

Frequently asked questions

What is io.github.rclone-ui/rclone?

MCP server for the Rclone RC API, with selectable toolsets.

How do I install io.github.rclone-ui/rclone?

It runs on your machine. In Claude Code: claude mcp add rclone -e 'RCLONE_URL=<RCLONE_URL>' -e 'RCLONE_USER=<RCLONE_USER>' -e 'RCLONE_PASS=<your rclone_pass>' -e 'RCLONE_TOOLSETS=<RCLONE_TOOLSETS>' -e 'RCLONE_READ_ONLY=<RCLONE_READ_ONLY>' -e 'RCLONE_MCP_MAX_OUTPUT=<RCLONE_MCP_MAX_OUTPUT>' -- npx -y rclone-mcp@2.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.rclone-ui/rclone need an API key?

Yes. It expects RCLONE_PASS, which you set in its configuration.

Is io.github.rclone-ui/rclone open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.rclone-ui/rclone?

It is published by rclone-ui. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.