insta360-cloud-mcp

MCP server for Insta360 cloud storage — browse, download, and manage your 360 media from any MCP client.

Features

• list_media — Fetch all media from your Insta360 cloud (auto-paginated)
• get_download_urls — Get download URLs for a specific media item
• download_media — Download all files for a specific media item
• download_all — Download your entire Insta360 cloud library
• delete_media — Move media items to the recycle bin

Prerequisites

• An Insta360 account with cloud storage
• uv installed

Quick Start (uvx)

Add to your MCP client config (e.g. claude_desktop_config.json or .claude/mcp_servers.json):

{
  "mcpServers": {
    "insta360": {
      "command": "uvx",
      "args": ["insta360-cloud-mcp"],
      "env": {
        "INSTA360_EMAIL": "your-email@example.com",
        "INSTA360_PASSWORD": "your-password"
      }
    }
  }
}

Quick Start (from source)

git clone https://github.com/alfari16/insta360-cloud-mcp.git
cd insta360-cloud-mcp

Then configure your MCP client:

{
  "mcpServers": {
    "insta360": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/insta360-cloud-mcp", "insta360-cloud-mcp"],
      "env": {
        "INSTA360_EMAIL": "your-email@example.com",
        "INSTA360_PASSWORD": "your-password"
      }
    }
  }
}

Environment Variables

| Variable | Description | |---|---| | INSTA360_EMAIL | Your Insta360 account email | | INSTA360_PASSWORD | Your Insta360 account password (MD5-hashed internally by the server) |

Tools Reference

| Tool | Parameters | Description | |---|---|---| | list_media | last_update_position? | Fetch all media items, auto-paginating through all pages | | get_download_urls | media_id | Get download URLs for a specific media item | | download_media | media_id, download_dir? | Download all files for a media item (default: ~/gdrive/Insta360) | | download_all | download_dir?, last_update_position? | Download entire cloud library | | delete_media | media_ids | Move media items to the recycle bin |

Token Caching

The server caches authentication tokens at ~/.insta360_tokens.json to avoid re-authenticating on every startup. Tokens are automatically refreshed when they expire. Delete this file to force a fresh login.

License

MIT