Microsoft Teams Not Working on Mac? 8 Fixes to Try in 2026

To fix Microsoft Teams on a Mac, quit it with Command-Q or force quit it, restart the Mac, then update both Teams and macOS. If it still fails, check the sign-in code, your VPN and macOS permissions, clear the cache, and reinstall. Need Teams right now? Sign in at teams.microsoft.com in a browser.

My weekly team update was two minutes away when the Teams icon bounced in my Dock and no window ever appeared. I joined from Chrome, ran the meeting, and only dealt with the app once it was over. This guide keeps that order: get into the meeting, work out whether the fault sits with Teams, your Mac or your network, then try eight fixes from quickest to most disruptive. Camera, microphone, screen sharing and notification problems each get their own steps further down.

How to join a Teams meeting when the Mac app won't open

You can join a Microsoft Teams meeting from a web browser or by phone, so a broken Mac app doesn't have to cost you the call. Try these in order:

1. Open the invite and click the meeting link. When asked, choose Continue on this browser. Microsoft's guest instructions name Microsoft Edge and Google Chrome.
2. Can't find the link? Enter the meeting ID and passcode on Microsoft's join page, which works in a browser with no app.
3. No internet you trust? Call in if the invite lists a phone number and conference ID.

Safari can run Teams too: Microsoft's requirements list the latest two versions of Safari on macOS, plus the latest three of Edge, Chrome and Firefox. In a meeting, your browser needs its own permission for the camera and microphone, and its own screen recording permission before you can present.

Is it Teams, your Mac or your network? Test the web app first

Signing in to Teams on the web tells you where the problem is, because it skips the Mac app completely. Go to teams.microsoft.com, sign in, and read the result. (Microsoft's web guide assumes a Microsoft 365 Business or Enterprise account, so a failed test proves less on a personal one.)

• The web version works. Your account and Microsoft's service are probably fine, so look at the Mac app or the Mac. Start with Fix 1 below.
• The web version fails too. Suspect your account, your network or Microsoft. Check Microsoft's service status page and the @MSFT365Status account on X, then try another network.
• Everything looks healthy but your whole team is stuck. Ask your IT admin. Service health in the Microsoft 365 admin center shows the issues affecting your organization, and it needs an admin sign-in.

If Microsoft Outlook is misbehaving at the same moment, a shared cause such as your network or account becomes more likely. Our Outlook freezing guide covers that app's side of things.

Find your Microsoft Teams fix by symptom

The symptom on your screen usually narrows down where to begin. Find yours here, then jump to that fix or section.

8 fixes for Microsoft Teams on a Mac

These eight Microsoft Teams fixes run from fastest to most disruptive, so test Teams after each one and stop as soon as it behaves.

Fix 1: Quit Teams properly, or force quit it

Closing the Teams window doesn't quit the app on a Mac, so press Command-Q, or Control-click the Teams icon in the Dock and choose Quit. If Teams won't respond, Apple's force quit steps work:

1. Press Option-Command-Esc.
2. Select Microsoft Teams in the Force Quit window.
3. Click Force Quit, then reopen Teams.

Fix 2: Restart your Mac

A restart has been Microsoft's own remedy for at least one Mac sign-in failure. After upgrading to macOS 15.3, some Macs with the Company Portal app couldn't sign in to Teams, and Microsoft's workaround was simply to restart the device. So don't skip it because it sounds too basic. Choose Apple menu > Restart, then open Teams before anything else.

Fix 3: Update Teams and macOS

An old Teams app or an unsupported macOS can stop Teams from working at all, so check both. On a Mac, Teams updates through Microsoft AutoUpdate. Choose Help > Check for Updates in the menu bar, and Microsoft says that opens AutoUpdate. If nothing happens, AutoUpdate may be missing or blocked, which is a question for your admin, or a reason to jump to Fix 8 on your own Mac.

One Mac detail catches a lot of us out. Microsoft says Teams for Mac doesn't restart itself to apply an update: it waits for you to quit. I used to leave Teams open for weeks and just close the window, which gives a downloaded update little chance to finish. Now I quit it when I stop for the evening. The same Microsoft page says a version one to three months old shows an in-app alert, and anything older gets a blocking page offering an update, your IT admin or Teams on the web.

For macOS, choose Apple menu > System Settings > General > Software Update, as Apple describes. Microsoft supports the Teams desktop app on the three most recent macOS versions only. Going by Apple's current list, that looks like this:

Not sure which you have? Choose Apple menu > About This Mac.

Fix 4: Read the sign-in code and check your Mac's clock

A failed Teams sign-in usually comes with a status code, and Microsoft says to look at the bottom-left corner of the sign-in window. The code tells you whether this is yours to fix:

• 0xCAA20003: an authorization problem, and wrong date or time settings can block the secure connection. Go to System Settings > General > Date & Time and turn on Set time and date automatically, as Apple explains.
• 0xCAA70007, 0xCAA82EE2 or 0xCAA82EE7: an interrupted connection, a timeout, or a server name that couldn't be resolved. Check your internet connection, then try Fix 5.
• 0xCAA70004: a server or proxy that can't be found, often from a misconfigured proxy. This one is for your IT admin.
• 0xCAA20004: a request that needs approval under your organization's policies, so your IT admin has to look at it.
• 0xCAA90018: the wrong credentials. Sign in again with the right email and password.

Microsoft also offers a Teams sign-in test, described in its sign-in guide, which checks whether your account meets the requirements to sign in. It's a useful answer to have before you message IT.

Fix 5: Test Teams without your VPN

A VPN can slow Teams or get in the way of its connection, so test without one if you're allowed to. Microsoft recommends that companies send Teams traffic around the VPN tunnel, a setup called split tunneling, because that traffic is highly sensitive to latency and bandwidth limits.

On a personal VPN, turn it off, quit and reopen Teams, and see what changes. On a company VPN, leave it alone and tell IT what you're seeing, using the words "split tunnel" so they know what you mean. A hotspot from your phone is another quick way to rule out your office or home network, if your company allows it.

Fix 6: Check macOS permissions for Teams

macOS controls Teams' access to your camera, microphone and screen, and a missing permission looks exactly like a broken app. Choose Apple menu > System Settings > Privacy & Security, then check each of these:

• Camera: turn on Microsoft Teams, which Microsoft's page lists as Microsoft Teams (work or school).
• Microphone: turn on Teams in the same place.
• Screen & System Audio Recording: turn on Microsoft Teams if you need to present.

If you change a switch, quit Teams and reopen it before you test. On a company Mac, a switch you can't change is usually set by IT.

Fix 7: Clear the Teams cache, for the right problems

Clearing the Teams cache is a targeted step for trouble with the installed app, and Microsoft says it's not a general first step. Its article specifically rules it out for missing messages, chat history that won't load, a missing team or channel, and wrong notifications or unread counts. Clearing doesn't fix those, and it deletes the diagnostic logs support would need.

That article doesn't list the problems clearing does help, so I save it for an app that won't start, or a window that stays blank after Fixes 1 to 3. If the problem may end up with IT, collect your logs first (see the IT section below). Then:

1. Quit Teams with Command-Q.
2. Open Terminal from Applications > Utilities.
3. Enter these two commands, pressing Return after each.
4. Reopen Teams, and give it longer than usual, since it has to rebuild those files.

rm -rf ~/Library/Group\ Containers/UBF8T346G9.com.microsoft.teams
rm -rf ~/Library/Containers/com.microsoft.teams2

Fix 8: Uninstall and reinstall Teams

Reinstalling is the last fix to try, since it replaces the app, and the Teams installer includes Microsoft AutoUpdate. Microsoft's Mac steps are short:

1. Quit Teams. If it's stuck, hold Option, Control-click the Dock icon and choose Force Quit.
2. Open your Applications folder and select Microsoft Teams.
3. Drag it to the Trash.
4. Download the latest installer from Microsoft's Teams download page, install it and sign in.

On a company-managed Mac, you may not have permission to install software, so ask IT to do it. You don't need a third-party cleaner app for any of this.

Microsoft Teams camera or microphone not working on a Mac

When the Teams camera or microphone fails on a Mac, the permissions in Fix 6 are the first check. After that, the cause is usually a device choice, another app, or a mute switch.

• Camera. Microsoft suggests closing other apps that may be using the camera, such as FaceTime, and unplugging and reconnecting an external camera.
• Microphone. Look at the Mic button: a line through the icon means you're muted. Check for a mute switch on your headset or external mic too.
• Device choice. In Teams, select Settings and more > Settings > Devices. Under Audio settings, pick your mic from the Microphone list and your output from the Speaker list.
• Test call. On that same screen, select Make a test call. It records a short message and plays it back. It's English only and isn't available in Teams on the web.
• Bluetooth. Microsoft's advice is to make sure the device is charged and isn't connected to anything else, then reconnect it.

That last one has caught me: I once talked at a silent meeting for a while because my earbuds were still connected to my phone. If you're mid-call and nothing helps, Microsoft says a Call me back option may appear, which moves your audio to your phone while your Mac keeps sharing content.

Microsoft Teams screen sharing not working on a Mac

Teams can't share your screen on a Mac without the Screen & System Audio Recording permission, and Microsoft says Teams asks for it the first time you share. If you missed the prompt:

1. Choose Apple menu > System Settings > Privacy & Security > Screen & System Audio Recording.
2. Turn on Microsoft Teams. If it isn't listed, Apple's guide says to use the Add button (+) under the list and find the app.
3. Return to the meeting, select Share again and choose what to share.

Still stuck? Microsoft's page suggests updating macOS, closing unused apps to free memory, and asking your IT admin if the Mac is managed. It also offers a different way to share: select Settings and more > Settings > General > Screen sharing, then Use macOS content sharing. No restart is needed, but you can't give or take control of content in that mode.

Three other things worth knowing. Prompts saying Teams is accessing your screen, which can appear from macOS Sequoia 15.2 on, are an Apple security change, according to Microsoft. DisplayLink and some other docks can make sharing indicators display incorrectly on macOS 14 and later, so try one share without the dock. And a Microsoft Q&A thread from April 2026 describes Teams asking for permission on a managed Mac running Tahoe 26.4 with the switch already on. It shows no confirmed fix, so in that situation use Teams on the web and report it to IT.

Microsoft Teams notifications not working on a Mac

Teams chat, channel and mention alerts on a Mac depend on macOS as well as on Teams, so a quiet Teams is often a macOS setting. Microsoft's notification guide points to four places:

1. Allow them. Go to System Settings > Notifications > Application Notifications > Microsoft Teams and turn on Allow notifications. Turn on Play sound for notification there as well if you want sound.
2. Check Focus. Go to System Settings > Focus, select each Focus you use, and add Teams under Allowed Apps. It's a per-Focus setting, so one change doesn't cover them all.
3. Check your display. With an external display or dock connected, alerts can land only in Notification Center. In System Settings > Notifications, turn on Allow notifications when mirroring or sharing the display.
4. Test it. In Teams, select Settings and more > Settings > Notifications and activity, then Test notification under Display.

I lost a whole morning to the second one. My team seemed unusually quiet, and it turned out a writing Focus I'd switched on was still running. Calls, requests to join and meeting start alerts don't depend on macOS settings, according to Microsoft, which is why those can still reach you while chat alerts stay silent.

Why Microsoft Teams is slow on a Mac

Teams can slow down when a Mac is short on memory or processor power, especially in bigger meetings. Microsoft's minimum for Mac is a dual-core processor, 4 GB of RAM and 1.5 GB of free disk space. For meetings of 10 or more people, it recommends a four-core processor from 2018 or newer.

So on an older MacBook, close what you don't need before a large call, including extra browser tabs. If Teams only struggles with big meetings and is fine in one-to-one calls, your Mac may be the limit, and a reinstall is unlikely to change that.

When to stop troubleshooting and call IT

Call IT when the sign-in code points to policy, when a setting is locked, or when the web version fails too and Microsoft reports no issue. Give them logs, because that saves everyone a round of questions. On a Mac, choose Help > Collect support files in Teams, or press Option-Command-Shift-1, per Microsoft's log guide. The files land in your Downloads folder. Microsoft says to collect them as soon as the issue occurs, and that log times are in UTC, so note your local time as well.

A message like this gives IT what they need on the first read:

Subject: Teams on my Mac: [problem] ([error code])

Hi,

Teams has failed on my Mac since about [time] today.

What happens: [the window stays blank / sign-in loops / error code]
Teams on the web: [works / also fails]
macOS version: [from Apple menu > About This Mac]
Already tried: quit and restart, Teams and macOS updates, VPN off
Logs: attached from Help > Collect support files

I have a meeting at [time], so I'll use the web version until then.

Thanks,
[Your name]

How to keep Teams from failing you before a big meeting

A short check before an important Microsoft Teams meeting catches many of these problems while you're still alone. This is my routine when a call really matters:

• Run the test call from Settings > Devices about ten minutes ahead.
• Keep the invite open in your calendar, so the link, meeting ID and any dial-in number are one click away.
• Sign in to Teams on the web once in a browser beforehand, so your fallback is ready if the app bounces.
• Quit Teams fully each evening, so waiting updates can install.
• Keep macOS within the three most recent versions.

If the audio is what's letting you down, live captions in Teams can help you follow along. And if Teams keeps failing for your kind of call and the choice is yours, compare it with Zoom and Google Meet or, for team chat, with Slack.