Skip to main content
Glama
jioaicloud-mcp-server

jioaicloud-mcp-server

by Ashu-codeai

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

Tool

Purpose

jio_login

Establish/refresh session + passphrase unlock

jio_send_otp / jio_verify_otp

First-time device login

jio_unlock_passphrase

Unlock passphrase 2FA

jio_auth_status

Session status (no secrets)

jio_import_session

Import browser userData JSON

jio_logout

Clear local session

jio_storage_usage

Quota / used storage

jio_list_files

List folder contents

jio_list_photos / jio_list_videos / jio_list_documents

Media inventories

jio_get_file

File metadata

jio_search_files

Keyword search

jio_backup_summary

Counts/bytes by category

jio_find_duplicates

Duplicate groups

jio_duplicate_report

Last duplicate report

jio_delete_files

Trash by ids (dry_run default)

jio_delete_duplicates

Trash duplicate candidates (dry_run default)

jio_download_file

Download to downloads/

jio_export_inventory

Export JSON/CSV inventory

jio_list_albums

List folder albums (kind=folder) or native boards (kind=board)

jio_create_album

Create folder album or native board album

jio_rename_album

Rename a folder album

jio_move_to_album

Move files/folders into a folder album

jio_add_to_board

Add Drive files into a native board album (boardId + ids)

jio_delete_album

Delete folder albums (trash) or board albums (kind=board, dry_run default)

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.

Available Tools

27 tools
jio_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

    B3.2/5.0

    Scored across 27 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      An 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.
      43
      1
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Local-first MCP server for safely searching, reading, summarizing, tagging, deduplicating, and organizing local files with scoped access, read-only defaults, and dry-run plans.
      19
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Read-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.
      6
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      A 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.
      6
      MIT