Remote Files MCP
About
MCP server for monitoring remote file sources, detecting new files, and extracting content. Works with any storage backend via rclone (70+ providers) or custom commands.
Details
- Author
- vinerima
- Categories
- File Management, Infrastructure, Automation
Jump to
Setup
Install Remote Files MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/vinerima/remote-files-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
MCP server for monitoring remote file sources, detecting new files, and extracting content. Works with any storage backend via rclone (70+ providers) or custom commands.
MCP server for monitoring remote file sources, detecting new files, and extracting content. Works with any storage backend via rclone (70+ providers) or custom commands.
- Multi-source monitoring— track multiple remote locations (Google Drive, S3, SFTP, local dirs, etc.)
- New file detection— state-based diffing detects new and changed files
- Content extraction— extracts text from DOCX, PDF, and plain text files
- Auto-cleanup— downloaded files are deleted after content extraction
- Hybrid transport— built-in rclone support + custom shell commands
- Node.js >= 18
- npm
- rclone(if using the rclone transport — the installer can install it for you)
The interactive installer handles dependencies, build, configuration, and Claude Code registration:
- Verify Node.js and npm are available
- Ask you to choose a transport mode (rclone or custom)
- Install rclone if needed (via brew, apt, pacman, or the official install script)
- Walk you through rclone remote configuration if no remotes exist yet
- Install npm dependencies and build the project
- Create the config file at~/.config/remote-files/config.json
- Register the MCP server with Claude Code (if the CLI is available)
If you prefer to set things up yourself:
cd remote-files npm install npm run build claude mcp add --transport stdio remote-files -- node /absolute/path/to/remote-files/dist/index.js
Then create~/.config/remote-files/config.jsonmanually (see Configuration below).
Create~/.config/remote-files/config.json:
{ "sources": { "my-drive": { "provider": "rclone", "remote": "gdrive:", "path": "Documents/Reports", "flags": ["--drive-shared-with-me"], "exclude": [".tmp"], "excludeFrom": "/path/to/exclude-patterns.txt" }, "my-server": { "provider": "custom", "listCommand": "ssh server 'find /data -type f -printf \"%s %P\\n\"'", "downloadCommand": "scp server:/data/$FILE $DEST/" } }, "settings": { "tempDir": "/tmp/remote-files", "stateDir": "~/.local/share/remote-files/state", "autoCleanup": true, "maxContentLength": 102400 } }
Override config path withREMOTE_FILES_CONFIGenv var.
Requiresrcloneinstalled and configured. Fields:
For any backend not covered by rclone. Fields:
Check for new/changed files without downloading.
Parameters: source? — specific source name (omit for all) include_pattern? — glob filter (e.g. ".docx")
Initialize a source baseline. All current files are marked as known.
Parameters: source — source name to initialize
Download a file, extract text, and auto-delete the local copy.
Parameters: source — source name path — file path (from check_sources) keep_local — if true, keep file on disk (default: false)
Returns extracted text for DOCX/PDF/TXT. For unknown formats, returnslocal_pathfor Claude to read directly.
- First time:Claude callsinit_sourceto create a baseline
- Ongoing:Claude callscheck_sourcesto find new files
- Per file:Claude callsfetch_fileto get content and summarize
- Files are auto-deleted after extraction
claude mcp remove remote-files rm -rf ~/.config/remote-files rm -rf ~/.local/share/remote-files
AI-first file sharing and collaboration. 251 MCP tools give agents a full workspace: file storage, branded shares, comments, workflows, and built-in RAG. 50GB free, no credit card.
MCP server that moves files between your filesystem and cloud storage.
Manage files and downloads on Synology NAS devices using an AI assistant.
Persistent memory for AI agents. Store and retrieve files via 14 MCP tools with OAuth 2.0 auth. Free 10GB tier.
Quickly integrate with Tencent Cloud Storage (COS) and Data Processing (CI) capabilities powered
An MCP server for managing files and buckets on AWS S3. Requires AWS credentials for authentication.
Publish HTML, Markdown, KV, JSON, files to brewpage.app from AI assistants.
An MCP server for interacting with Dropbox files and services.
A read-only MCP server by CData that allows LLMs to query live Dropbox data. Requires the CData JDBC Driver for Dropbox.
An MCP server for integrating with Dropbox, allowing clients to interact with files and folders.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
