Microsoft Teams mode — connect your Luxafor device to your Teams status (Windows & macOS)

Teams mode lets your Luxafor device mirror your Microsoft Teams presence automatically. When you're available, the device is green. When you're busy or in a meeting, it's red. When you're on a call, it flashes red for the whole duration, then returns to your normal status colour the moment the call ends.

No manual switching, no browser extension — the Luxafor app reads your Teams presence directly.

Available on: Luxafor Flag, Flag 2, Orb, Bluetooth, Bluetooth PRO and Busy Tag Supported systems: Windows 10 / 11 and macOS

A note on Skype for Business: Microsoft has fully retired Skype for Business, so the old coexistence modes (Islands, Skype for Business with Teams Collaboration, and so on) no longer exist. Every Microsoft 365 tenant now runs in Teams Only mode, which means the instructions below are the only ones you need.

Before you start

• Install the latest version of the Luxafor desktop app — luxafor.com/download
• Have Microsoft Teams installed and signed in — download Teams
• Use the same Microsoft account in both Teams and the Luxafor app
• If you're on a work or school account, your IT administrator may need to approve Luxafor's access to your presence information. See the troubleshooting section below.

Setup

1. Connect your Luxafor device to your computer (USB) or pair it over Bluetooth, and confirm the app detects it.
2. Open the Luxafor app and go to the Microsoft Teams tab.
3. Sign in with your Microsoft account. A Microsoft sign-in window will open — this is Microsoft's own login, not ours, and we never see your password.
4. Approve the permission request. Luxafor asks only for read access to your presence status.
5. Set your idle and status colours if you want something other than the defaults.
6. Test it. Change your status in Teams manually — the device should follow within a few seconds.

That's it. Your Luxafor device now:

• Shows your Teams availability status as a colour;
• Flashes red for the full duration of any call or meeting;
• Returns to your status colour immediately after the call ends.

Troubleshooting

The device doesn't change colour at all

1. Confirm the device works outside Teams mode — set a solid colour manually in the app. If that fails, it's a device or connection issue, not a Teams issue.
2. Make sure the Luxafor app is actually running (check the system tray on Windows or the menu bar on macOS — closing the window usually minimises rather than quits).
3. In Teams, change your status manually and use Reset status. This forces Microsoft to re-publish your presence.
4. Restart the Luxafor app.

Sign-in fails or keeps asking you to sign in again (most common on macOS)

This is a cached-credential problem, not a device fault. It usually clears with:

1. Sign out of Teams mode inside the Luxafor app, then quit the app completely.
2. Open Keychain Access, search for stored Microsoft or Luxafor credential entries, and delete them.
3. Reopen the Luxafor app and sign in again.

If the loop returns after a few days, email us at support@luxafor.com with your macOS version and Luxafor app version — we're actively tracking this and it helps to have your case attached to the report.

Status updates, but there's no red flash during calls

Teams publishes an "In a call" presence separately from your availability. If it isn't coming through:

1. Use Reset status in Teams.
2. Check that you're joining calls from the Teams app you signed into, not a second account or the browser version signed in as someone else.
3. If presence is stuck in Teams itself — for example, still showing "Available" while you're clearly in a meeting — the issue is on Microsoft's side. Contact Microsoft Teams support.

Sign-in is blocked by your organisation

Some companies restrict which third-party apps can read presence data. If you see a message about needing administrator approval, forward the request to your IT administrator — they can approve Luxafor for your tenant. We only request read access to presence.

The app doesn't detect your device

• USB devices (Flag, Flag 2, Orb): use the original cable and try a different port. Some cables are charge-only and carry no data.
• Bluetooth devices (Bluetooth, Bluetooth PRO): re-pair the device in your system Bluetooth settings, then reconnect in the app.
• Busy Tag: confirm it appears as a connected device before opening the Teams tab.

Full setup guides for each device are in our product manuals.

Still stuck? Email support@luxafor.com — include your operating system, Luxafor app version and device model, and we'll get you sorted.