DMJBot - Personal AI Assistant

rclone Remote MCP Server

Wiki / Tools

rclone Remote MCP Server

The rclone Remote server lets DMJBot work with files on any rclone remote — S3, Google Drive, OneDrive, Backblaze B2, SFTP, and the dozens of other backends rclone supports. It talks to a running rclone rcd HTTP API and exposes one configured remote as file tools (same vocabulary as File Storage and Dropbox).

What DMJBot can do

  • folder_contents — list the entries inside a remote folder.
  • file_metadata — get metadata for a file or folder.
  • file_contents / file_contents_base64 — read a file as text or base64.
  • create_folder — create a folder on the remote.
  • save_file — upload a file from base64 content.
  • delete_file / delete_folder — delete a file or folder (recursive optional).
  • move_path — move or rename a file or folder.

Notification

  • new_file — a new file appears under a monitored remote folder during polling. Monitoring is recursive within each listed folder.

Before you start

  1. Install rclone and configure your remote with rclone config on the host machine.

  2. Start the remote-control daemon:

    rclone rcd --rc-addr :5572 --rc-user USER --rc-pass PASS
# or, without auth:
rclone rcd --rc-addr :5572 --rc-no-auth

    Authentication is the optional Basic auth of the rcd API (--rc-user / --rc-pass) — there is no OAuth here; the remote's own credentials live in rclone's config on the rcd host.

Add the server

The rclone Remote server is bundled in the DMJBot catalog. Add it either in DMJBot itself or on a connected device (it must be able to reach the rcd URL):

  • In DMJBot: Settings -> Tools, add the rclone Remote server from the catalog, and fill in the configuration fields below.

  • On a device (bridge):

    dmjbot-bridge install rclone-rcd
dmjbot-bridge configure rclone-rcd
dmjbot-bridge start

You can run more than one instance — give each a distinct Storage Title so DMJBot can tell them apart.

Configuration

Field Required Default Description
rclone rcd URL yes — Base URL of the running rclone rcd, e.g. http://localhost:5572.
Remote Name yes — rclone remote to use. Bare name for the whole remote (mydrive), or scope to a sub-path (s3:my-bucket/reports). All operations are relative to this root.
rcd Username no (empty) Username for the rcd Basic auth (--rc-user). Leave empty if rcd runs with --rc-no-auth.
rcd Password no (empty) Password for the rcd Basic auth (--rc-pass). Sensitive. Leave empty for --rc-no-auth.
Storage Title no rclone Storage Short label prefixed into the server name and tool descriptions so DMJBot can pick the right instance when several are loaded.
Monitored Folders no (empty) Comma-separated remote-relative paths to watch for new files (recursive). Empty disables monitoring.
Monitor Interval (s) no 60 How often monitored folders are polled (minimum 5).
Monitor New Files no true Run the new-file poller.

Boolean fields accept true/false, 1/0, t/f.

Tips

  • Scope the Remote Name to a specific bucket/folder (remote:bucket/sub) to keep DMJBot confined to just that area.
  • Run rclone rcd as a service on the host so the API is always available.

See also