io.github.rclone-ui/rclone MCP Server
io.github.rclone-ui/rclone
MCP server for Rclone RC API—manage cloud storage, copy/sync files, and list directories via natural language.
What this kind of tool is for
- Automate a build, test, or deployment step you repeat by hand.
- Review or refactor code in an existing repository without leaving your agent.
- Bridge an internal service or CLI into the agent toolset.
How to compare servers like this
- Scope of control:
- Repos and CI are hard to undo; prefer tools that ask before anything irreversible.
- Environment fit:
- Match the runtime it expects (Node, Python, a container) to what you actually run.
- Maintenance signal:
- Check the last-commit date — dev tooling that lags upstream breaks first.
- Config surface:
- Prefer tools whose environment-variable or config keys are documented plainly.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the io.github.rclone-ui/rclone MCP server?
The rclone-mcp MCP server exposes the Rclone RC API with 98 endpoints organized into selectable toolsets, enabling AI assistants to manage cloud storage remotes, copy/sync files, list directories, and perform other cloud operations. It auto-generates tools from the rclone-openapi spec and supports read-only mode for safe, restricted access.
rclone-mcp bridges AI assistants to Rclone's remote control daemon, letting you manage cloud storage operations through natural language. You can list directories, copy/sync files across remotes, configure storage backends, and more—with fine-grained control via toolset selection and read-only mode.
How to install io.github.rclone-ui/rclone
Copy-paste configuration for popular MCP clients.
RCLONE_URLRclone RC daemon URL
RCLONE_USERHTTP Basic Auth username
RCLONE_PASSsecretHTTP Basic Auth password
RCLONE_TOOLSETSComma-separated list of toolsets to enable (default, all, or specific: core, config, operations, sync, jobs, vfs, mount, etc.)
RCLONE_READ_ONLYSet to 1 to disable write tools
{
"mcpServers": {
"rclone": {
"command": "npx",
"args": [
"-y",
"rclone-mcp"
],
"env": {
"RCLONE_URL": "<YOUR_RCLONE_URL>",
"RCLONE_USER": "<YOUR_RCLONE_USER>",
"RCLONE_PASS": "<YOUR_RCLONE_PASS>",
"RCLONE_TOOLSETS": "<YOUR_RCLONE_TOOLSETS>",
"RCLONE_READ_ONLY": "<YOUR_RCLONE_READ_ONLY>"
}
}
}
}Tools & capabilities
Tools this server exposes to the agent.
core— Core rclone operations and RC API endpoints (/core/*, /rc/*)config— Configuration management for storage remotes (/config/*)operations— File operations including copy, move, delete, and listing (/operations/*)sync— Sync and bisync operations between remotes (/sync/*)jobs— Job management and monitoring (/job/*)vfs— Virtual filesystem operations (/vfs/*)mount— Mount and unmount operations (/mount/*)serve— Serve operations for HTTP/WebDAV/FTP (/serve/*)cache— Cache management (/cache/*)debug— Debug and profiling tools (/debug/*)backend— Backend-specific operations (/backend/*)options— Options and configuration queries (/options/*)plugins— Plugin control (/pluginsctl/*)fscache— Filesystem cache operations (/fscache/*)
Use cases
- List files and directories across multiple cloud storage remotes
- Copy or sync files between cloud storage backends using natural language commands
- Configure and manage Rclone storage remotes through AI assistance
- Monitor and manage Rclone jobs and operations
- Provide read-only cloud storage access to AI assistants for safe exploration
io.github.rclone-ui/rclone MCP server FAQ
rclone-mcp is an MCP server that connects AI assistants to Rclone's remote control API, exposing 98 endpoints for managing cloud storage operations like copying, syncing, listing, and configuring remotes.
Yes, rclone-mcp is open-source under the MIT license.
Add the server to your `.cursor/mcp.json` or `claude_desktop_config.json` with the command `npx -y rclone-mcp` and set the `RCLONE_URL` environment variable to your Rclone RC daemon (default: http://localhost:5572).
You need a running Rclone RC daemon. If your daemon requires authentication, set `RCLONE_USER` and `RCLONE_PASS` environment variables.
Yes. Use `RCLONE_TOOLSETS` to enable only specific toolsets (core, config, operations, sync, jobs, vfs, mount, serve, cache, debug, backend, options, plugins, fscache), or set `RCLONE_READ_ONLY=1` to expose only non-mutating read tools.
rclone-mcp supports any backend that Rclone supports (S3, Google Drive, OneDrive, Azure Blob, local filesystem, SFTP, etc.) since it communicates with an existing Rclone RC daemon.
README (reference)
Source of truth, from the repository.
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
| Variable | Description | Default |
|---|---|---|
RCLONE_URL | rclone RC daemon URL | http://localhost:5572 |
RCLONE_USER | HTTP Basic Auth username | — |
RCLONE_PASS | HTTP Basic Auth password | — |
RCLONE_TOOLSETS | Comma-separated toolset list | default |
RCLONE_READ_ONLY | Set 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.
| Toolset | Paths | Default |
|---|---|---|
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
<div align="center"> <a href="https://discord.gg/rclone"> <img src="https://img.shields.io/badge/Discord-%235865F2.svg?&logo=discord&logoColor=white&style=for-the-badge"> </a> </div> <div align="center"> <sub>Made with ☁️ for the rclone community</sub> </div>Related MCP servers

Tentra — Memory for AI Coding Agents
Memory for AI coding agents. Call graphs + refactor safety + persistent code context. 35 MCP tools.
Unified app publishing MCP Server for Google Play, App Store, and 10+ Chinese stores
View repository →
ReadyAgents
Local YAML/JSON agent workflow CLI with approvals, resume, and optional stdio or loopback MCP HTTP.

io.github.reagost/nerve-rpc
MCP server for Nerve blockchain JSON-RPC & REST API for AI Agents

RCSB PDB
MCP server to search, inspect, and cross-reference RCSB Protein Data Bank structures

SQL Benchmarks Lab
Query pre-computed SQL engine benchmarks. Runs standalone, no server setup required.
