Setting up Guru's app for Microsoft Teams

The Guru app for Microsoft Teams brings your team's knowledge into the conversations where work happens. Message Guru directly or @mention it in a channel to get a sourced answer from a Knowledge Agent, search and share Cards, and get notified about Guru activity, all without leaving Teams.

The same app also works as an agent in Microsoft 365 Copilot. Learn more about using Guru in Microsoft 365 Copilot.

Guru just launched a new version of our team's app! Learn how to update your existing connection here.

Setting up the Guru app in Microsoft Teams

Part 1: Enable and install the Guru app

1. Open Microsoft Teams in your browser or desktop app.
2. Click the Apps icon on the left sidebar to open the app marketplace.
3. Search for Guru.

4. Click Open, then select Add to a team and choose the team or channel where you want to enable Guru.

5. The Guru bot will post a welcome message in the team's General channel and DM you with a personal welcome.

Part 2: Authenticate and log in

1. Click the Guru app icon below any message composer in Teams and select Settings.

2. Click Sign in. A browser window will open prompting:
   • A unique 6-digit code
   • Guru account login (if not already signed in)

3. Copy the 6-digit code from Guru and paste it back into the authentication prompt.
4. Once verified, you’re fully connected and ready to search, share, and view Guru content within Teams. After you sign in, Guru shows a short welcome carousel that introduces how to ask questions and search for Cards. The help command also responds before you sign in, so you can see what Guru can do at any time.

Asking Guru a question

Once you're signed in, send Guru a direct message and ask a question in plain language. Learn more about asking Guru questions in Microsoft Teams.

To have Guru answer in a channel, a Knowledge Agent owner needs to assign an agent to that channel.

Frequently Asked Questions

My organization blocks 3rd-party app installs. How do I get Guru in Teams?

Ask your M365 or IT Admin to whitelist Guru in Microsoft Teams.

Will Guru respect access permissions in Teams?

Yes. Guru verifies that users are logged in and have permission to view a Card before displaying its content in Teams.
Learn more about inviting users to Guru and setting Card permissions.

What operating systems does the Guru app for Teams support?

Guru works across all OS and environments supported by Microsoft Teams. Learn more here.

Why does my Card look different in Teams?

Card formatting may appear slightly different due to Microsoft Teams' display limitations. Guru is continuously improving formatting fidelity within Teams.

How do I switch Guru teams in Microsoft Teams?

To log into a different Guru team:

1. Sign out of the Guru app in Teams (via Settings).
2. In your browser, log into the new team in Guru.
3. Return to Teams, Sign in, and grant permissions to the new team.

Do I need to install a new app to get AI answers?
No. The Guru app for Microsoft Teams is the same app in the Teams store, so you don't need a separate listing, but you will need to update the app. If your organization already has Guru installed, it updates to include AI answers.

What happens if I message Guru in a DM or a channel with no assigned Knowledge Agent?
Guru uses your workspace's default Knowledge Agent. If your workspace doesn't have a default agent, Guru in Teams falls back to searching for Cards.

Can Guru respond to every message in a channel?
Yes, in channels where the Guru app is installed and a Knowledge Agent is assigned. A Knowledge Agent owner can set Auto-respond in channel to respond to all messages. If you'd like a quieter start, choose Only when @mentioned first. Learn more about managing channel settings.

Do I need a Microsoft 365 Copilot license to use Guru in Teams?
No. You don't need a Microsoft 365 Copilot license to use Guru in Teams or in Copilot Chat.

Can Guru take actions from Teams, like creating drafts or calling MCP tools?
Guru in Teams can use read-only tools and tools you've already approved in Guru. Teams doesn't have an in-line approval prompt, so anything that still needs approval won't run from Teams.

Does Guru answer in Outlook email or in Word, PowerPoint, and Excel comments?
No. Guru is available in the Copilot pane inside Word, PowerPoint, and Excel, but it doesn't answer in Outlook email or in document comments.