TeamsFixer
de en

Teams works in the browser but not in the app

https://teams.microsoft.com is fine, the desktop client shows errors or is dead. Diagnostic path with solution order.

Last verified:

Affected systems

windows macos

Quick fixes

  • That tells you: account and network are fine, the desktop client is broken
  • Clear cache, scrub credentials/keychain, restart Teams
  • If nothing works: uninstall and reinstall Teams

What you already know

If Teams works in the browser but the desktop client does not, you can rule out:

  • Account and password are correct
  • MFA works
  • Tenant license is fine
  • Microsoft services are up (no service outage)
  • Your network allows Teams endpoints

So the problem is local to the desktop client. That narrows the search massively.

Diagnostic order

1. Clear cache (fixes the majority)

Windows

%appdata%\Microsoft\Teams
%localappdata%\Packages\MSTeams_8wekyb3d8bbwe\LocalCache

Delete both folders, restart Teams.

macOS

~/Library/Application Support/Microsoft/Teams
~/Library/Group Containers/UBF8T346G9.com.microsoft.teams

Delete both folders, restart Teams.

2. Reset stored credentials

Windows

Open Credential Manager (control.exe /name Microsoft.CredentialManager), delete entries with “Microsoft”, “msTeams”, “OfficeApps”.

macOS

Open Keychain Access, search for “Microsoft” and “Office”, delete all matches.

3. Check WebView2 / runtime

Windows

In “Apps and Features”, verify “Microsoft Edge WebView2 Runtime” is installed. If missing or very old: reinstall from https://developer.microsoft.com/microsoft-edge/webview2/

Repair mode often suffices: entry → Modify → Repair.

macOS

No WebView2 needed. On Apple Silicon: verify you have the right Teams build (universal binary runs natively, old Intel builds need Rosetta).

4. Antivirus / firewall

Some antivirus tools block Teams selectively. If the browser works but the desktop client does not, the app firewall is often the cause. Add Teams as an exception.

5. Reinstall Teams

If everything above failed:

Windows

  1. Settings → Apps → Microsoft Teams → Uninstall
  2. Also uninstall “Microsoft Teams classic” if present
  3. Manually delete cache folders (step 1)
  4. Reinstall from https://teams.microsoft.com/downloads

macOS

  1. Quit Teams
  2. Drag the app from Applications to the Trash
  3. Manually delete cache folders (step 1)
  4. Reinstall from https://teams.microsoft.com/downloads

Use the web in the meantime

If no time for debugging: pin https://teams.microsoft.com in the browser. The web client is now nearly feature-equal with the desktop. Enable browser notifications in site settings - that gives you essentially app functionality without the broken client.

Related errors