How to clear Microsoft Teams cache on Mac

Decide whether a Teams cache reset fits

Do not use cache deletion as a general response to a Teams problem. Microsoft's current troubleshooting article specifically advises against it for missing chats or channels, message history that fails to load, and incorrect notification or unread counts. Removing the cache also removes diagnostic logs that may be needed to investigate those symptoms.

First record the problem and the installed Teams version. Quit and reopen the app normally, check your connection, and compare the same account in the Teams web app if your organization permits it. A problem that appears in both places is a reason to investigate the account, service or network, rather than repeatedly resetting this Mac.

If support asks for logs, collect them before a reset. On a work or school Mac, check with IT before changing app data: device management, sign-in policy and required configuration can affect the result. If you need an immediate meeting workaround, use an approved browser or another device instead of starting a reset just before the call.

Use the current Teams paths, not the classic path

Microsoft labels the current Mac instructions New Teams. Its two targets are:

• ~/Library/Group Containers/UBF8T346G9.com.microsoft.teams
• ~/Library/Containers/com.microsoft.teams2

The tilde means your own home folder. Neither target means the whole Containers or Group Containers directory, and neither means every folder containing “Microsoft.” Office, Outlook, OneDrive and other apps can keep unrelated data beside these targets.

The older ~/Library/Application Support/Microsoft/Teams path belongs to classic Teams. Microsoft's retirement page says classic Teams stopped being available on 1 July 2025. Clearing its old files is not the current-client reset, and a leftover classic folder is not evidence that the current app uses it.

Protect local work and access before changing files

Keep a note of settings you would need to restore, such as a chosen microphone or camera. Do not assume a server copy contains an unsent draft, an unfinished upload or a local recording.

Deleting local app data does not delete your organization's cloud account. It is also not a supported way to revoke a former employee's access, remove an organization from an account, or cancel a subscription. Those require the appropriate Microsoft account or administrator controls.

Clear Microsoft Teams cache on Mac with Finder

Microsoft publishes Terminal deletion commands for the two current-client folders. The Finder sequence below is our reviewable adaptation of those same targets; Microsoft does not present it as a separate Mac reset button. It avoids a permanent shell deletion, and opening each folder by its full path means you don't have to pick it out by name. It has not been device-tested for this guide.

1. Quit Teams completely. Use Microsoft Teams › Quit Microsoft Teams where offered, or press Command-Q with Teams active. If it immediately restarts under management, stop and ask IT.
2. Open the first folder by its full path. In Finder choose Go › Go to Folder, paste ~/Library/Containers/com.microsoft.teams2 and press Return. Apple's Finder pathname guide explains this navigation. Finder lists the folders in Containers by app name, and several of them can relate to Teams, so open this one by its path rather than choosing it from the list.
3. Select it. Choose Go › Enclosing Folder (Command-↑). Finder moves up to Containers with the folder you just opened selected.
4. Move it to the Trash. Choose File › Move to Trash. Leave the other folders in Containers alone.
5. Do the same for the group container. Choose Go › Go to Folder, paste ~/Library/Group Containers/UBF8T346G9.com.microsoft.teams and press Return. Then choose Go › Enclosing Folder to select it, and File › Move to Trash.
6. Reopen Teams. Allow it to rebuild local data, sign in if asked, then repeat the original action. Microsoft's guide says rebuilding can make the first start take longer.

If you use Microsoft's Terminal commands instead, quote the path, because “Group Containers” contains a space. Keep the tilde outside the quotation marks so it still means your home folder: ~/"Library/Group Containers/UBF8T346G9.com.microsoft.teams".

If Go to Folder can't find one of the paths, do not create it or substitute a similarly named folder. Confirm the installed edition with support. If macOS refuses access or reports the folder in use, do not work around it with broad permissions changes, administrator deletion commands or credential removal.

Leaving items in the Trash provides a chance to review what moved, but it does not guarantee that putting an old container back will safely merge with newly rebuilt data. Keep your backup. Emptying the Trash is a separate permanent removal; do not do it before you have confirmed what you need to keep.

Check the result without repeating the reset

Test the action that failed, rather than only checking whether the window opens. Confirm your account, required workspace and normal calls or file access. Restore necessary app preferences. If the same problem remains, report the version, error, time and the fact that a reset was already tried.

A reset can cause fresh downloads and background work, so an immediate change in CPU or storage is not a battery or speed benchmark. Avoid running a cleanup repeatedly because a number has not yet settled. For a generally slow Mac, use the wider diagnosis; for storage alone, the cache guide explains why deleting caches is not a lasting space strategy.

Removing Teams is a different task. The Microsoft app removal guide separates the app, Office's shared data and Teams. Do not combine every removal procedure into one reset.

How Tend helps

Tend's Free app view shows CPU, memory, estimated watts and 24 hours of energy history, which can put a busy Teams app in context. Pro adds longer energy history. Tend helps you look after your Mac; its optional companion shows how it's doing. Tend can't repair a Teams account, find a missing cloud message or decide which reset is right; use Microsoft's procedure and your IT team's advice for that.

Questions

Related guides

Sources and method

Sources checked on 30 October 2026. Steps were checked against Microsoft's and Apple's documentation; we did not reset Teams on a Mac for this guide.

• Microsoft: Clear the Teams client cache, updated 14 September 2026
• Microsoft: End of availability for classic Teams
• Apple: Go directly to a specific folder in Finder
• Apple: Delete or uninstall apps on Mac

Spotted something out of date? Tell us and we'll fix it.