Muin is in private beta.Watch the public release announcement —talk to us.
Falaah Falaah AI

Connecting Cloud Storage

Import documents from Google Drive, OneDrive, and Dropbox into Muin. Set up a one-time import or continuous sync so new files process automatically.

Connect Muin to your cloud storage to import existing documents and automatically sync new files. Muin supports Google Drive, Microsoft OneDrive, and Dropbox.

Supported Cloud Storage

ServiceFeatures
Google DrivePersonal & Workspace accounts, shared drives
Microsoft OneDrivePersonal & Business accounts
DropboxPersonal & Business accounts, team folders

Why Connect Cloud Storage?

Benefits

  • Import existing documents - Bring in your document library
  • Automatic sync - New files process automatically
  • Single source of truth - Documents indexed and searchable
  • Team collaboration - Shared folders sync for all users
  • No duplicate uploads - Reference files where they live

How It Works

Cloud Storage ──→ Muin Connector ──→ Document Processing ──→ Searchable
     │                  │                    │                   │
  Your files      Sync/import           AI extraction        Ready to use

Setting Up Google Drive

Prerequisites

  • Google account with Drive access
  • Workspace accounts: Appropriate permissions from admin

Connection Steps

  1. Navigate to SettingsIntegrationsCloud Storage
  2. Click Connect Google Drive
  3. Sign in with your Google account
  4. Review and approve permissions:
    • View and download files
    • View folder structure
  5. Click Allow
  6. Connection established

Selecting Folders

After connecting:

  1. Click Configure next to Google Drive
  2. Click Select Folders
  3. Browse your Drive structure
  4. Check folders to include
  5. Click Save Selection

Google Workspace Shared Drives

For shared drives:

  1. Enable “Include Shared Drives” in settings
  2. Select shared drives to sync
  3. Appropriate permissions required

Setting Up OneDrive

Prerequisites

  • Microsoft account with OneDrive access
  • Business accounts: Microsoft 365 subscription

Connection Steps

  1. Navigate to SettingsIntegrationsCloud Storage
  2. Click Connect OneDrive
  3. Sign in with your Microsoft account
  4. Review and approve permissions
  5. Click Accept
  6. Connection established

Selecting Folders

After connecting:

  1. Click Configure next to OneDrive
  2. Click Select Folders
  3. Browse your OneDrive structure
  4. Check folders to include
  5. Click Save Selection

SharePoint Libraries (Coming Soon)

SharePoint document library integration is on our roadmap. In the meantime, you can upload SharePoint documents directly or use OneDrive which shares the same Microsoft account.


Setting Up Dropbox

Prerequisites

  • Dropbox account
  • Business accounts: Appropriate team permissions

Connection Steps

  1. Navigate to SettingsIntegrationsCloud Storage
  2. Click Connect Dropbox
  3. Sign in with your Dropbox account
  4. Review and approve permissions
  5. Click Allow
  6. Connection established

Selecting Folders

After connecting:

  1. Click Configure next to Dropbox
  2. Click Select Folders
  3. Browse your Dropbox structure
  4. Check folders to include
  5. Click Save Selection

Dropbox Team Folders

For team folders:

  1. Enable “Include Team Folders” in settings
  2. Select team folders to sync
  3. Team admin permissions may be required

Import Options

Choose how to bring files into Muin.

One-Time Import

Import existing files without ongoing sync:

  1. Connect your cloud storage
  2. Select folders
  3. Choose One-Time Import
  4. Click Start Import
  5. Files are copied to Muin
  6. No automatic updates

Best for:

  • Archival migration
  • Historical documents
  • When you want files only in Muin

Continuous Sync

Keep Muin synchronized with cloud storage:

  1. Connect your cloud storage
  2. Select folders
  3. Choose Continuous Sync
  4. Set sync frequency:
    • Real-time (immediate)
    • Hourly
    • Daily
  5. Click Enable Sync

Best for:

  • Active document folders
  • Vendor invoice folders
  • Team collaboration folders

Folder Mapping

Route different folders to different modules:

Cloud FolderMuin ModuleDocument Type
/InvoicesFinanceInvoice
/ContractsVendorsContract
/HR DocumentsHRAuto-detect

Configure in SettingsCloud StorageFolder Mapping


Managing Connections

Viewing Connection Status

See all connections at SettingsIntegrationsCloud Storage

StatusMeaning
🟢 ConnectedActive and syncing
🟡 SyncingCurrently processing
🔴 ErrorConnection issue
⚪ DisconnectedNot connected

Triggering Manual Sync

To sync immediately:

  1. Click Sync Now next to the connection
  2. Muin checks for new/changed files
  3. New files are processed
  4. Status updates when complete

Viewing Sync History

See what’s been synced:

  1. Click History next to the connection
  2. View recent sync events
  3. See files imported
  4. Identify any errors

Modifying Folder Selection

To change which folders sync:

  1. Click Configure next to the connection
  2. Update folder selections
  3. Add or remove folders
  4. Click Save
  5. Changes take effect immediately

Disconnecting

Temporary Pause

To pause syncing without disconnecting:

  1. Click Pause next to the connection
  2. Sync stops
  3. Click Resume to restart

Full Disconnect

To remove the connection:

  1. Click Disconnect next to the connection
  2. Confirm disconnection
  3. Connection removed
  4. Previously imported documents remain in Muin

Note: Disconnecting doesn’t delete documents already in Muin.


Sync Behavior

What Gets Synced

  • Supported file types: PDF, images, Office documents
  • New files: Added since last sync
  • Modified files: Changes to existing synced files
  • Deleted files: Optionally removed from Muin

What Doesn’t Sync

  • Files over 50 MB (unless enterprise plan)
  • Unsupported file types
  • Files in excluded folders
  • Files you don’t have permission to access

Conflict Handling

When files change in both places:

  • Cloud priority: Cloud version overwrites Muin version
  • Version history: Previous versions retained in Muin
  • Notification: You’re notified of conflicts

Troubleshooting

Connection Failed

Symptoms: Can’t connect or authorize

Solutions:

  1. Verify account credentials
  2. Check you have access to the cloud service
  3. Clear browser cache and retry
  4. For business accounts, check with IT admin
  5. Try incognito/private browser window

Sync Not Working

Symptoms: New files not appearing in Muin

Solutions:

  1. Check connection status (should be green)
  2. Verify folder is in selected folders
  3. Confirm file type is supported
  4. Check file size (under 50 MB)
  5. Trigger manual sync
  6. Review sync history for errors

Permission Issues

Symptoms: “Access denied” or missing folders

Solutions:

  1. Verify you have access in cloud storage
  2. For shared/team folders, check permissions
  3. Reconnect with appropriate account
  4. For business accounts, admin may need to grant access

Large Import Taking Too Long

Symptoms: Import running for hours

Context: Large imports can take time. For 10,000+ files:

  1. Initial import may take 4-8 hours
  2. Progress shown on dashboard
  3. You’ll be notified when complete
  4. Can continue using Muin during import

Security Considerations

Permissions Granted

When you connect cloud storage, Muin gets:

  • Read access to selected folders
  • View folder structure
  • Download files for processing

Muin does not get:

  • Write access (can’t modify your cloud files)
  • Delete access (can’t delete your cloud files)
  • Access to unselected folders

Data Handling

  • Files are processed on Muin’s secure infrastructure
  • Extracted data stored in Muin
  • Original files may be cached temporarily
  • Your data stays within Muin’s own infrastructure

Revoking Access

You can revoke Muin’s access anytime:

  1. Go to your cloud storage security settings
  2. Find Muin in connected apps
  3. Remove access
  4. Connection will show as “Error” in Muin

Best Practices

Folder Organization

  1. Dedicated sync folders - Create folders specifically for Muin sync
  2. Clear structure - Organize by document type or vendor
  3. Avoid deep nesting - Keep folder structure simple
  4. Clean up regularly - Remove old files from sync folders

Sync Configuration

  1. Start small - Begin with one folder, expand later
  2. Use folder mapping - Route to correct modules automatically
  3. Set appropriate frequency - Real-time for active folders, daily for archives
  4. Monitor initially - Watch sync activity for first week

Team Collaboration

  1. Coordinate folder selection - Avoid duplicate syncs
  2. Use shared/team folders - Single source of truth
  3. Document sync setup - Team members know what’s syncing
  4. Assign ownership - Someone responsible for sync health

Next Steps

Now that you’ve connected cloud storage: