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: File Organizer MCP

Setup

npm install
cp .env.example .env

Edit .env (do not commit it):

JIOAICLOUD_ID=your-jio-id-or-login
JIOAICLOUD_MOBILE=91XXXXXXXXXX
JIOAICLOUD_PASSPHRASE=your-passphrase

Optional for first login only:

JIOAICLOUD_OTP=123456

Run

npm run dev
# or
npm run build && npm start

Cursor 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.

1. Call jio_send_otp

2. Call jio_verify_otp with the SMS code (or set JIOAICLOUD_OTP and call jio_login)

3. Passphrase unlock runs automatically when 2FA/passphrase is enabled

4. 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

Albums notes

• Folder albums (kind=folder) are normal My Files folders — this is what the organize scripts use (year/month albums under Photo Albums).

• Board albums (kind=board) are native JioAICloud Albums. Create/list with album tools; add Drive files with jio_add_to_board; delete/leave with jio_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_run defaults to true

• Real deletes require dry_run=false and confirm=true

• Max 50 ids per delete call

• Deletes use the trash API (recoverable from JioAICloud Trash)

Security

• Never paste credentials into chat

• .env and .session/ are gitignored

• Tokens are not printed by auth status tools

Inspector

npm run inspector

License

MIT — personal use with your own JioAICloud account.