jioaicloud-mcp-server
Provides tools for managing JioAICloud backups, including inventorying photos, videos, and documents, finding duplicates, trashing duplicates, managing folder and board albums, and checking storage usage.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@jioaicloud-mcp-server find duplicates in my JioAICloud backup"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
JioAICloud Local MCP Server
Local Model Context Protocol (MCP) server for managing your JioAICloud backups from Cursor: inventory photos/videos/documents, find duplicates, and safely trash duplicates.
JioAICloud has no public developer API. This server talks to the same private HTTPS endpoints used by https://www.jioaicloud.com. Use it only with your own account.
Features
Auth with Mobile + Passphrase (saved session for day-to-day use)
First-time OTP helpers when no local session exists yet
Browse / search backups (photos, videos, documents)
Create / list / rename / move-into / trash folder albums
List / create / add-to / delete native JioAICloud board albums
Storage quota summary
Duplicate detection (checksum, else name+size)
Safe deletes (dry-run by default; trash API)
Download files and export inventory JSON/CSV
Related MCP server: FilePilot AI
Setup
npm install
cp .env.example .envEdit .env (do not commit it):
JIOAICLOUD_ID=your-jio-id-or-login
JIOAICLOUD_MOBILE=91XXXXXXXXXX
JIOAICLOUD_PASSPHRASE=your-passphraseOptional for first login only:
JIOAICLOUD_OTP=123456Run
npm run dev
# or
npm run build && npm startCursor MCP config
Add to your Cursor MCP settings (mcp.json):
{
"mcpServers": {
"jioaicloud": {
"command": "node",
"args": ["dist/index.js"],
"cwd": "/absolute/path/to/jio-mcp-server"
}
}
}On Windows, set cwd to your full project path with escaped backslashes, e.g. "C:\\path\\to\\jio-mcp-server".
Put credentials in the project .env only (not in mcp.json). Run npm run build after code changes.
First login flow
JioAICloud’s web API requires an OTP to create a new device session. After that, Mobile + Passphrase (saved under .session/) is enough.
Call
jio_send_otpCall
jio_verify_otpwith the SMS code (or setJIOAICLOUD_OTPand calljio_login)Passphrase unlock runs automatically when 2FA/passphrase is enabled
Later sessions: just
jio_login
You can also call jio_import_session with userData JSON exported from the browser’s localStorage if you already have a logged-in web session.
Tools
Tool | Purpose |
| Establish/refresh session + passphrase unlock |
| First-time device login |
| Unlock passphrase 2FA |
| Session status (no secrets) |
| Import browser userData JSON |
| Clear local session |
| Quota / used storage |
| List folder contents |
| Media inventories |
| File metadata |
| Keyword search |
| Counts/bytes by category |
| Duplicate groups |
| Last duplicate report |
| Trash by ids ( |
| Trash duplicate candidates ( |
| Download to |
| Export JSON/CSV inventory |
| List folder albums ( |
| Create folder album or native board album |
| Rename a folder album |
| Move files/folders into a folder album |
| Add Drive files into a native board album ( |
| Delete folder albums (trash) or board albums ( |
Albums notes
Folder albums (
kind=folder) are normal My Files folders — this is what the organize scripts use (year/month albums underPhoto Albums).Board albums (
kind=board) are native JioAICloud Albums. Create/list with album tools; add Drive files withjio_add_to_board; delete/leave withjio_delete_album(kind=board,PUT /invites/boards/{boardKey}/unjoin). Board delete does not trash the underlying Drive files.Folder album delete uses Trash (recoverable). Board unjoin removes the album from your list.
Delete safety
dry_rundefaults totrueReal deletes require
dry_run=falseandconfirm=trueMax 50 ids per delete call
Deletes use the trash API (recoverable from JioAICloud Trash)
Security
Never paste credentials into chat
.envand.session/are gitignoredTokens are not printed by auth status tools
Inspector
npm run inspectorLicense
MIT — personal use with your own JioAICloud account.
Available Tools
27 toolsjio_add_to_boardA
Add existing Drive files into a native JioAICloud board album by boardKey. Files stay in My Files (link/copy into the board). Max 50 ids per call.
Inputs: ids (required), boardId (required).
jio_auth_statusA
Show whether a local JioAICloud session exists (no secrets).
Inputs: no named parameters.
jio_backup_summaryA
Summarize photo/video/document/audio/other backup counts and bytes (first page sample per category).
Inputs: sampleLimit.
jio_create_albumA
Create an album. kind=folder creates a My Files folder (recommended for organizing photos/videos). kind=board creates a native JioAICloud Album; use jio_add_to_board to add existing Drive files.
Inputs: name (required), kind, parentId, description.
jio_delete_albumA
Delete albums. kind=folder moves folder album(s) to Trash by objectKey. kind=board deletes/leaves native board albums by boardKey (PUT /invites/boards/{id}/unjoin). dry_run=true by default; real delete requires dry_run=false and confirm=true. Board delete does not trash Drive files.
Inputs: ids (required), kind, confirm, dry_run.
jio_delete_duplicatesA
Trash delete-candidates from the last jio_find_duplicates run. dry_run=true by default; real delete needs dry_run=false and confirm=true.
Inputs: all, confirm, dry_run, groupIds.
jio_delete_filesA
Move files to trash by objectKey ids. dry_run=true by default. Real delete requires dry_run=false and confirm=true.
Inputs: ids (required), confirm, dry_run.
jio_download_fileC
Download a file by objectKey to the local downloads folder.
Inputs: id (required), destPath.
jio_duplicate_reportA
Return the last jio_find_duplicates report from this session.
Inputs: no named parameters.
jio_export_inventoryB
Export an inventory of photos/videos/documents (or all) to JSON/CSV under downloads/.
Inputs: format, category, filename, maxPages.
jio_find_duplicatesC
Find duplicate files among photos/videos/documents (or a custom list). Groups by checksum when available, else name+size.
Inputs: policy, category, maxPages, dateWindowMs.
jio_get_fileB
Get metadata for a single file by objectKey/id.
Inputs: id (required).
jio_import_sessionB
Import a browser userData JSON blob (from localStorage) to create a local session, then unlock with passphrase.
Inputs: userDataJson (required).
jio_list_albumsA
List albums. kind=folder lists folders under a parent (default root) — these are the album folders used for organizing media. kind=board lists native JioAICloud Albums.
Inputs: kind, limit, nextLink, parentId.
jio_list_documentsC
List backed-up documents.
Inputs: limit, allPages, nextLink.
jio_list_filesB
List files/folders under a folder (defaults to root).
Inputs: sort, type, limit, nextLink, +1 more.
jio_list_photosC
List backed-up photos.
Inputs: limit, allPages, nextLink.
jio_list_videosC
List backed-up videos.
Inputs: limit, allPages, nextLink.
jio_loginA
Log in to JioAICloud using env credentials (Mobile + Passphrase). Uses saved session when possible. For first-time login on this machine, send OTP first (jio_send_otp / jio_verify_otp) or set JIOAICLOUD_OTP.
Inputs: no named parameters.
jio_logoutA
Clear the local saved session.
Inputs: no named parameters.
jio_move_to_albumA
Move files or folders into a folder album by destination albumId (folder objectKey). Pass optional items[] with name/objectType/sourceName for best results. For native board albums, use jio_add_to_board instead.
Inputs: ids (required), albumId (required), items.
jio_rename_albumB
Rename a folder album by objectKey/id. parentId should be the current parent folder key when known.
Inputs: id (required), name (required), parentId.
jio_search_filesC
Search files by keyword.
Inputs: query (required), limit.
jio_send_otpA
Send login OTP SMS to JIOAICLOUD_MOBILE (needed only for first login when no local session exists).
Inputs: no named parameters.
jio_storage_usageA
Get storage quota / usage for the logged-in account.
Inputs: no named parameters.
jio_unlock_passphraseB
Unlock account passphrase (2FA) using JIOAICLOUD_PASSPHRASE.
Inputs: no named parameters.
jio_verify_otpA
Verify OTP and establish a session, then unlock with passphrase from env.
Inputs: otp (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 27 tools
Most tools target distinct resources and actions (login, files, albums, duplicates). The only potential confusion is between move_to_album and add_to_board, and the multiple list_* commands, but descriptions clarify these differences.
All tools follow a consistent jio_verb_noun pattern with snake_case, making the action and target predictable. There are no mixed conventions or vague names.
At 27 tools, the server exceeds the 25-tool threshold and feels heavy for a cloud storage integration. While each tool is distinct, the count suggests the API surface could be consolidated.
Missing file upload (create) is a major gap for a cloud storage server. Also absent are file rename, restore from trash, and sharing. Album, backup, and duplicate management are well covered, but the core file lifecycle is incomplete.
Related MCP Connectors
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
MCP server exposing the YourImageShare upload API (upload/list/delete) as tools for AI agents.
An MCP server for search and retrieval over a local LanceDB database
Related MCP Servers
- FlicenseAqualityDmaintenanceAn MCP server for Immich self-hosted photo management that provides AI-accessible tools for browsing, searching, organizing, and managing photo libraries with duplicate detection and safe deletion workflows.431-
- AlicenseNot gradedqualityCmaintenanceLocal-first MCP server for safely searching, reading, summarizing, tagging, deduplicating, and organizing local files with scoped access, read-only defaults, and dry-run plans.19MIT
- AlicenseAqualityCmaintenanceRead-only MCP server that exposes your local Notion backups to AI agents — query databases, read pages, search a backed-up workspace. Offline by default: no LLM calls, no telemetry, no cloud.61MIT
- AlicenseAqualityBmaintenanceA local, read-only MCP server that lets AI agents inspect and analyze photo libraries by scanning files, aggregating EXIF stats, finding duplicates, scoring blur, and generating cull reports without uploading any data.6MIT