{
  "markdown": "# rclone-mcp\n\n[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?&logo=discord&logoColor=white)](https://discord.gg/rclone)\n\nMCP (Model Context Protocol) server for the [Rclone](https://rclone.org/) RC API. Gives AI assistants the ability to manage cloud storage remotes, copy/sync files, list directories, and more — all through natural language.\n\nTools are auto-generated from the [rclone-openapi](https://github.com/rclone-ui/rclone-openapi) spec using the [rclone-sdk](https://github.com/rclone-ui/rclone-sdk) client. 98 endpoints, organized into selectable toolsets.\n\n## Prerequisites\n\nA running rclone remote control daemon:\n\n```bash\nrclone rcd --rc-no-auth\n# or with auth:\nrclone rcd --rc-user=admin --rc-pass=secret\n```\n\n## Installation\n\n### Cursor / Claude Desktop (stdio)\n\nAdd to your `.cursor/mcp.json` or `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"rclone\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"rclone-mcp\"],\n      \"env\": {\n        \"RCLONE_URL\": \"http://localhost:5572\"\n      }\n    }\n  }\n}\n```\n\n### With authentication\n\n```json\n{\n  \"mcpServers\": {\n    \"rclone\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"rclone-mcp\"],\n      \"env\": {\n        \"RCLONE_URL\": \"http://localhost:5572\",\n        \"RCLONE_USER\": \"admin\",\n        \"RCLONE_PASS\": \"secret\"\n      }\n    }\n  }\n}\n```\n\n### Docker\n\n```bash\ndocker build -t rclone-mcp .\n\ndocker run -i --rm \\\n  -e RCLONE_URL=http://host.docker.internal:5572 \\\n  rclone-mcp\n```\n\n### Streamable HTTP transport\n\nFor remote hosting or web-based MCP clients:\n\n```bash\nnpx rclone-mcp http --port 3000\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Description | Default |\n|---|---|---|\n| `RCLONE_URL` | rclone RC daemon URL | `http://localhost:5572` |\n| `RCLONE_USER` | HTTP Basic Auth username | — |\n| `RCLONE_PASS` | HTTP Basic Auth password | — |\n| `RCLONE_TOOLSETS` | Comma-separated toolset list | `default` |\n| `RCLONE_READ_ONLY` | Set to `1` to disable write tools | — |\n\n### CLI Arguments\n\n```\nrclone-mcp [command]\n\nCommands:\n  rclone-mcp stdio  Run with stdio transport (default)\n  rclone-mcp http   Run with Streamable HTTP transport\n\nOptions:\n  --toolsets   Comma-separated list of toolsets\n  --read-only  Only expose read-only tools\n  --port       HTTP port (http command only, default: 3000)\n```\n\n## Toolsets\n\nTools are grouped by API path prefix. Enable only what you need to keep the tool list focused.\n\n| Toolset | Paths | Default |\n|---|---|---|\n| `core` | `/core/*`, `/rc/*` | Yes |\n| `config` | `/config/*` | Yes |\n| `operations` | `/operations/*` | Yes |\n| `sync` | `/sync/*` | Yes |\n| `jobs` | `/job/*` | No |\n| `vfs` | `/vfs/*` | No |\n| `mount` | `/mount/*` | No |\n| `serve` | `/serve/*` | No |\n| `cache` | `/cache/*` | No |\n| `debug` | `/debug/*` | No |\n| `backend` | `/backend/*` | No |\n| `options` | `/options/*` | No |\n| `plugins` | `/pluginsctl/*` | No |\n| `fscache` | `/fscache/*` | No |\n\nSpecial values:\n- `default` — the four default toolsets (core, config, operations, sync)\n- `all` — every toolset\n\n### Examples\n\n```bash\n# Default toolsets (55 tools)\nnpx rclone-mcp\n\n# Everything (98 tools)\nRCLONE_TOOLSETS=all npx rclone-mcp\n\n# Just file operations and config\nnpx rclone-mcp --toolsets operations,config\n\n# Default + mount\nnpx rclone-mcp --toolsets default,mount\n\n# Read-only mode (no copy, delete, sync, etc.)\nnpx rclone-mcp --read-only\n```\n\n## Read-Only Mode\n\nWhen `--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.\n\n## License\n\nMIT\n\n<div align=\"center\">\n<a href=\"https://discord.gg/rclone\">\n<img src=\"https://img.shields.io/badge/Discord-%235865F2.svg?&logo=discord&logoColor=white&style=for-the-badge\">\n</a>\n</div>\n\n<div align=\"center\">\n<sub>Made with ☁️ for the rclone community</sub>\n</div>\n\n",
  "bytes": 3920,
  "sha": "831192209f5bf675e5a3ac2af25b3a90b33ef944000cd9a4a53f94cb086aef79",
  "repo_slug": "rclone-ui/rclone-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rclone_ui_rclone_a46e1358/readme"
}