OneDrive File Issues

How to Fix OneDrive Sync for Teams Guests on Mac

Muhammad TalhaMuhammad Talha Oct 21, 2026 868 views

Question details

An external Microsoft Teams guest can access shared files online but experiences synchronization issues when attempting to sync them locally on a Mac.

How to Fix OneDrive Sync for Teams Guests on Mac
Product
OneDrive
Device & OS
Mac
Scenario
Attempting to sync shared Teams files to a local Mac environment as an external guest user.
Observed behavior
Shared files can be accessed and viewed via the Teams or SharePoint web interface, but the OneDrive Mac client remains stuck or fails to sync the files locally.
Before you start

Ensure you are connected to a stable internet network and verify that you are currently signed into the exact Microsoft account that was granted guest access to the Teams channel.

Solution 1Recommended

Initiate Sync via SharePoint and Clear Stale Connections

Clear old account credentials from your Mac and trigger a fresh synchronization directly from the underlying SharePoint library.

OneDrive sync issues on Mac often occur when cached credentials from other work or school accounts conflict with your Teams guest account. Clearing these and using the direct SharePoint sync method can establish a clean connection.

1
Clear Stale Connections

Sign out of your OneDrive app. Then, open the 'Keychain Access' app on your Mac, search for 'OneDrive', and delete any existing cached work or school account credentials.

2
Access the SharePoint Library

Open Microsoft Teams, navigate to the specific channel where the files are shared, click the 'Files' tab at the top, and select 'Open in SharePoint'.

3
Trigger the Sync

In the SharePoint web interface, locate and click the 'Sync' button in the top menu bar. This will prompt your browser to open the local OneDrive app.

4
Sign In with the Guest Account

When the OneDrive app opens, carefully sign in using the exact email address and credentials associated with your guest access.

Initiate Sync via SharePoint and Clear Stale Connections
Account Verification: Double-check your account details during sign-in to ensure your Mac isn't automatically defaulting to a previously saved personal or different organizational account.
Free Microsoft Office alternative

Switch to WPS Office for Seamless Document Collaboration

If you frequently encounter cross-tenant syncing blocks and permission errors with Microsoft Office and OneDrive, consider using WPS Office. It provides a lightweight, highly compatible alternative for creating, sharing, and collaborating on documents natively on your Mac without complex guest access restrictions.

  1. 1. Download the App: Visit the official WPS Office website and download the free version tailored specifically for macOS.
  2. 2. Install and Launch: Open the downloaded package, drag the WPS Office icon to your Applications folder, and launch the suite.
  3. 3. Share and Collaborate: Open your documents and use the built-in sharing features to generate links for your external team members, enabling immediate collaboration without enterprise sync hurdles.
Avoid complex Teams guest permission and OneDrive cross-tenant sync errors with straightforward file sharing.Fully compatible with Microsoft Word, Excel, and PowerPoint file formats (.docx, .xlsx, .pptx).Built-in cloud storage options that make real-time collaboration effortless across different organizations.Lightweight architecture optimized for Mac, ensuring rapid launch times and smooth performance.Completely free to use with a familiar interface that requires zero learning curve.
microsoft office alternative - wps office

Frequently Asked Questions

Why does OneDrive get stuck syncing shared Teams files on a Mac?

This commonly occurs due to conflicting cached credentials in the macOS Keychain, signing in with the wrong account profile, or restrictive cross-tenant sync policies implemented by the host organization's IT administrators.

Do I need a special Microsoft 365 license to sync Teams guest files?

No special license is required on your end to sync shared files as a guest. However, the host organization must explicitly allow external B2B (Business to Business) synchronization in their Azure AD and SharePoint settings.

How do I clear old OneDrive credentials on my Mac?

Open the 'Keychain Access' app from your Mac's Utilities folder, type 'OneDrive' in the search bar, and delete the cached credential entries. Restart your OneDrive application to force a fresh sign-in prompt.

Can I sync just a specific Teams folder instead of the entire SharePoint library?

Yes. Instead of syncing the root directory, navigate to the specific folder within the Teams 'Files' tab or the SharePoint site, and click the 'Sync' button from within that folder to only synchronize its contents to your Mac.