English Français العربية

io.github.rclone-ui/rclone

Registre officiel Autres

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.rclone-ui/rclone ?

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

Comment installer io.github.rclone-ui/rclone ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.rclone-ui/rclone ?

Oui. Il attend RCLONE_PASS, à renseigner dans sa configuration.

io.github.rclone-ui/rclone est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.rclone-ui/rclone ?

Il est publié par rclone-ui. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.