sodcalculator

10 Tech How-To

Teams Not Working on Mac? Fixes That Work

Guide 10-21315 · Updated · Step by step

If Microsoft Teams is not working on your Mac—whether it won’t open, keeps crashing, or shows a blank screen—the fix is usually a combination of clearing the cache, updating the app, and checking your network or permissions. Below are the specific steps to resolve the most common Mac-specific Teams issues, followed by background on why they happen and how to prevent them.

Why Teams Fails on Mac Specifically

Teams on macOS shares most of its code with the Windows version, but Mac users hit a few unique problems. The most frequent culprit is the app’s cached data: Teams stores a lot of temporary files locally, and on macOS these can become corrupted after a system update or a forced quit, leading to blank windows, login loops, or the app not launching at all. Another Mac-specific factor is the permission system—Teams needs microphone, camera, and notification access, and macOS will silently block these if you didn’t grant them on first launch. Finally, older macOS versions (pre-Big Sur) are no longer officially supported by Microsoft, so the app may behave erratically or refuse to update on them.

First Steps: Restart and Update

Before diving into deeper fixes, do these two quick things—they resolve a surprising number of cases.

  • Fully quit Teams: Right-click the Teams icon in the Dock and choose Quit, or press Cmd+Q. Then reopen it from Applications.
  • Check for macOS updates: Go to System Settings (or System Preferences on older macOS) → General → Software Update. Install any pending updates, as Teams often breaks after a macOS point release until Microsoft patches compatibility.
  • Update Teams itself: Teams doesn’t update automatically on Mac as reliably as on Windows. Click your profile picture in Teams → Check for updates. If the app won’t open at all, download the latest installer from Microsoft’s website and run it over the existing installation.

If Teams still won’t work after these, move to the cache clear below.

Clear the Teams Cache (The #1 Fix)

The Teams cache lives in ~/Library/Application Support/Microsoft/Teams. Corrupted files here cause most persistent problems: blank screens, “Something went wrong” errors, or the app opening then immediately quitting. Here’s how to clear it safely:

  1. Quit Teams completely (Cmd+Q).
  2. Open Finder, press Cmd+Shift+G, and paste ~/Library/Application Support/Microsoft/Teams. Press Enter.
  3. You’ll see folders like Cache, Code Cache, GPUCache, IndexedDB, and Service Worker. Delete the contents of these folders—not the folders themselves. You can select all and move to Trash.
  4. Also delete the blob_storage and databases folders if present.
  5. Empty the Trash, then relaunch Teams. You’ll need to sign in again, but your chats and files are safe—they’re stored in the cloud.

This clears the local cache without removing your account or settings. If Teams still misbehaves, also delete the Preferences folder inside the same Teams directory (this resets your UI settings but not your data).

Check Permissions and Network

If Teams opens but your microphone or camera doesn’t work in meetings, macOS is likely blocking access. Go to System Settings → Privacy & Security, then check Microphone, Camera, and Notifications. Make sure Microsoft Teams is toggled on for each. If it’s already on, toggle it off and on again to reset the permission.

Network issues can also masquerade as app failures. Teams requires stable HTTPS connections to Microsoft’s servers. If you’re on a corporate VPN or a restrictive firewall, try:

  • Disconnecting the VPN and testing again.
  • Switching from Wi-Fi to a wired connection or vice versa.
  • Flushing DNS: open Terminal and run sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder (you’ll need your admin password).
  • Checking if a proxy is set in System Settings → Network → Wi-Fi → Details → Proxies. If you don’t need one, turn it off.

Reinstall Teams (Nuclear Option)

If nothing above works, a clean reinstall is the next step. This removes all local data and gives you a fresh start. Here’s the complete uninstall process:

  1. Quit Teams.
  2. Move the Teams app from Applications to Trash.
  3. Also delete the entire ~/Library/Application Support/Microsoft/Teams folder (not just its contents) and ~/Library/Preferences/com.microsoft.teams.plist if it exists.
  4. Empty the Trash and restart your Mac.
  5. Download the latest Teams installer from Microsoft’s official site and install it.
  6. Sign in and test.

This is safe—your messages, files, and meeting history are all stored server-side. You’ll just need to reconfigure your profile picture and notification preferences.

Common Misconception: Teams vs. Teams Classic

Many Mac users don’t realize there are two versions of Teams: the classic desktop app and the new “Teams 2.0” (sometimes called Teams Classic in the app switcher). If you’re running the older version, it may be deprecated and failing. Check your app’s About screen: if it says version 1.x, you’re on the old one. The new Teams is faster and more stable on Mac. If you have the old version, uninstall it and install the new one from Microsoft’s website—the app will prompt you to switch, but you can also force it by downloading the “new Teams” installer directly.

Frequently Asked Questions

Why does Teams keep crashing on my Mac?
Most often it’s corrupted cache or an outdated app. Clear the cache as described above, then check for updates. If it still crashes, try reinstalling. Also, check if you’re running macOS Monterey or older—Microsoft dropped support for those, so the app may be unstable.

Why is Teams showing a blank white screen on Mac?
This is almost always a cache issue. The app loads its UI from local files, and when those are corrupted, you get a blank window. Clear the cache folders (Cache, Code Cache, GPUCache, etc.) and relaunch. If that doesn’t work, reinstall.

Why can’t I sign in to Teams on Mac?
Check your internet connection first. Then try signing in via a browser to confirm your credentials work. If the app won’t accept them, clear the cache and try again. Corporate accounts may also require multi-factor authentication—make sure you complete that prompt.

Why is Teams using so much CPU on my Mac?
Teams is known for high CPU usage, especially on older Macs. The new Teams 2.0 is significantly lighter. If you’re on the old version, switch. Also, disable hardware acceleration in Teams settings (Settings → General → Disable GPU hardware acceleration) and close unused chat tabs.

Why is my camera not working in Teams on Mac?
First, check macOS permissions: System Settings → Privacy & Security → Camera, and ensure Teams is checked. If it is, quit Teams, restart your Mac, and try again. If other apps can use the camera, the issue is Teams-specific—try reinstalling.

Can I use Teams in a browser instead of the Mac app?
Yes. Go to teams.microsoft.com and sign in. The web version supports most features, including meetings and chat, and often works when the desktop app fails. It’s a good temporary fix while you troubleshoot the app.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →