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

Tools Reference

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