> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams

> Use Runable inside Microsoft Teams. Chat with the agent in DMs, group chats, and channels.

The Teams integration brings Runable into Microsoft Teams. Once installed and connected, you can chat with Runable in personal chats, group chats, and channels. Just mention @Runable and ask it to do anything. Generated files like decks, documents, and reports are uploaded to your team's SharePoint so you can open them natively in Microsoft 365.

## How to connect

<Steps>
  <Step title="Open RunClaw Page">
    In the Runable web app, go to **Sidebar** → **Run Claw**. You can also go to **Settings** → **Runclaw** and find the **Teams** option there.

    <Frame caption="The Run Claw tab in Settings showing the Teams Connect button.">
      <img alt="Screenshot 2026 04 25 At 6 37 39 PM" title="Screenshot 2026 04 25 At 6 37 39 PM" lightAlt="Screenshot 2026 04 25 At 6 37 39 PM" darkAlt="Screenshot 2026 04 25 At 6 37 39 PM" src="https://mintcdn.com/runableinc/gB6o39YgqwosUHnl/images/Screenshot-2026-04-25-at-6.44.42-PM.png?fit=max&auto=format&n=gB6o39YgqwosUHnl&q=85&s=528097200d33009faac3d0613af0c05e" className="dark:hidden" width="2990" height="1618" data-path="images/Screenshot-2026-04-25-at-6.44.42-PM.png" />

      <img alt="Screenshot 2026 04 25 At 6 37 39 PM" title="Screenshot 2026 04 25 At 6 37 39 PM" lightAlt="Screenshot 2026 04 25 At 6 37 39 PM" darkAlt="Screenshot 2026 04 25 At 6 37 39 PM" src="https://mintcdn.com/runableinc/gB6o39YgqwosUHnl/images/Screenshot-2026-04-25-at-6.44.02-PM.png?fit=max&auto=format&n=gB6o39YgqwosUHnl&q=85&s=5952d4533039301718c21ebf575a8c39" className="hidden dark:block" width="2990" height="1618" data-path="images/Screenshot-2026-04-25-at-6.44.02-PM.png" />
    </Frame>
  </Step>

  <Step title="Connect Teams">
    Click the **Connect** button on the Teams card. You will get the Teams app package and a short lived connect token.

    <Frame>
      <img alt="Screenshot 2026 04 25 At 6 37 39 PM 1" title="Screenshot 2026 04 25 At 6 37 39 PM 1" lightAlt="Screenshot 2026 04 25 At 6 37 39 PM 1" darkAlt="Screenshot 2026 04 25 At 6 37 39 PM 1" src="https://mintcdn.com/runableinc/F_AjZ52FY05lbGwm/images/Screenshot-2026-05-12-at-10.15.44-AM.png?fit=max&auto=format&n=F_AjZ52FY05lbGwm&q=85&s=51076db8b7080cedd5c031fbf7759878" className="dark:hidden" width="2992" height="1626" data-path="images/Screenshot-2026-05-12-at-10.15.44-AM.png" />

      <img alt="Screenshot 2026 04 25 At 6 37 39 PM 1" title="Screenshot 2026 04 25 At 6 37 39 PM 1" lightAlt="Screenshot 2026 04 25 At 6 37 39 PM 1" darkAlt="Screenshot 2026 04 25 At 6 37 39 PM 1" src="https://mintcdn.com/runableinc/F_AjZ52FY05lbGwm/images/Screenshot-2026-05-12-at-10.15.32-AM.png?fit=max&auto=format&n=F_AjZ52FY05lbGwm&q=85&s=011eb9154a5dc7a0ab7a944c3b9d50e6" className="hidden dark:block" width="2992" height="1626" data-path="images/Screenshot-2026-05-12-at-10.15.32-AM.png" />
    </Frame>
  </Step>

  <Step title="Install the app in Teams">
    Upload the app package in Teams. Open Teams, go to **Apps** → **Manage your apps** → **Upload an app**, and pick the file you just downloaded to sideload your app.

    <Frame>
      <img alt="Image Xezqnja2y5" lightAlt="Image Xezqnja2y5" darkAlt="Image Xezqnja2y5" src="https://mintcdn.com/runableinc/F_AjZ52FY05lbGwm/images/Screenshot-2026-05-12-at-10.51.02-AM.png?fit=max&auto=format&n=F_AjZ52FY05lbGwm&q=85&s=3fac17e305f8c8bdbb99965ac9579e93" className="dark:hidden" width="2992" height="1692" data-path="images/Screenshot-2026-05-12-at-10.51.02-AM.png" />

      <img alt="Image Xezqnja2y5" lightAlt="Image Xezqnja2y5" darkAlt="Image Xezqnja2y5" src="https://mintcdn.com/runableinc/F_AjZ52FY05lbGwm/images/Screenshot-2026-05-12-at-10.50.39-AM.png?fit=max&auto=format&n=F_AjZ52FY05lbGwm&q=85&s=acdd9c3cef50d288c12483682a8c811c" className="hidden dark:block" width="2992" height="1692" data-path="images/Screenshot-2026-05-12-at-10.50.39-AM.png" />
    </Frame>
  </Step>

  <Step title="Link your account">
    Open a chat with the Runable bot, mention @Runable, run `/connect`, and paste the token from the Runclaw page. The token expires in 10 minutes.

    <Frame>
      <img alt="Screenshot 2026 04 25 At 7 15 25 PM" title="Screenshot 2026 04 25 At 7 15 25 PM" lightAlt="Screenshot 2026 04 25 At 7 15 25 PM" darkAlt="Screenshot 2026 04 25 At 7 15 25 PM" src="https://mintcdn.com/runableinc/F_AjZ52FY05lbGwm/images/Group-3.png?fit=max&auto=format&n=F_AjZ52FY05lbGwm&q=85&s=b12b654308222e7e73683a721aa591b5" className="dark:hidden" width="1496" height="846" data-path="images/Group-3.png" />

      <img alt="Screenshot 2026 04 25 At 7 15 25 PM" title="Screenshot 2026 04 25 At 7 15 25 PM" lightAlt="Screenshot 2026 04 25 At 7 15 25 PM" darkAlt="Screenshot 2026 04 25 At 7 15 25 PM" src="https://mintcdn.com/runableinc/F_AjZ52FY05lbGwm/images/Group-6.png?fit=max&auto=format&n=F_AjZ52FY05lbGwm&q=85&s=616db2115b67e6ee02086ada02853d7e" className="hidden dark:block" width="1496" height="846" data-path="images/Group-6.png" />
    </Frame>
  </Step>

  <Step title="Approve admin permissions">
    After the connect succeeds, the bot will share an admin consent link. A Teams admin needs to open it once and approve. This let's the bot read files in channels and group chats and upload generated files to your SharePoint. Without this, file features will not fully work.

    <Frame>
      <img alt="Admin consent" lightAlt="Admin consent" darkAlt="Admin consent" src="https://mintcdn.com/runableinc/F_AjZ52FY05lbGwm/images/Group-2.png?fit=max&auto=format&n=F_AjZ52FY05lbGwm&q=85&s=5bc8f0977a3304b884d5e4dde569d076" className="dark:hidden" width="1496" height="846" data-path="images/Group-2.png" />

      <img alt="Admin consent" lightAlt="Admin consent" darkAlt="Admin consent" src="https://mintcdn.com/runableinc/F_AjZ52FY05lbGwm/images/Group-5.png?fit=max&auto=format&n=F_AjZ52FY05lbGwm&q=85&s=853d4f7f7dbcef52017c0f3b147d25e3" className="hidden dark:block" width="1496" height="846" data-path="images/Group-5.png" />
    </Frame>
  </Step>

  <Step title="Start Chatting">
    Mention @Runable in any DM, group chat, or channel and ask it to do anything.

    <Frame>
      <img alt="Teams chat with Runable" lightAlt="Teams chat with Runable" darkAlt="Teams chat with Runable" src="https://mintcdn.com/runableinc/F_AjZ52FY05lbGwm/images/Group-1.png?fit=max&auto=format&n=F_AjZ52FY05lbGwm&q=85&s=d546e320c2d5e9c8269a3158c59cf5d5" className="dark:hidden" width="1496" height="846" data-path="images/Group-1.png" />

      <img alt="Teams chat with Runable" lightAlt="Teams chat with Runable" darkAlt="Teams chat with Runable" src="https://mintcdn.com/runableinc/F_AjZ52FY05lbGwm/images/Group-4.png?fit=max&auto=format&n=F_AjZ52FY05lbGwm&q=85&s=08c314ee2283939c7ff3cead7548f252" className="hidden dark:block" width="1496" height="846" data-path="images/Group-4.png" />
    </Frame>
  </Step>
</Steps>

## Send files

Attach files to your messages the way you normally do in Teams. The agent receives and processes all file types. In DMs files come through directly. In group chats and channels the bot pulls them from SharePoint or OneDrive using the admin approved permissions.

## Supported Commands

| Command     | What it Does                                                                                                 |
| ----------- | ------------------------------------------------------------------------------------------------------------ |
| `/connect`  | Link your Runable account to Teams. Paste the token from the Runclaw page after running this.                |
| `/newchat`  | Start a fresh session in the current chat or channel.                                                        |
| `/openchat` | View your current session and open it in the Runable web app.                                                |
| `/settings` | Open settings to change chat mode, model tier, and chat model. Only the user who connected can change these. |

## How to disconnect

Go back to **Settings** → **Run Claw** in the Runable web app. Click **Disconnect** on the Teams card. You can also uninstall the Runable app from Teams directly.

## Important Details

* When one user runs `/connect` in a Teams tenant, the whole workspace is linked to that user's Runable account. Everyone in that tenant who uses the bot will run against that account, and all usage is billed to it.
* Only the user who connected can change settings like chat mode, model tier, and chat model.
* A Teams admin needs to approve the consent link once for file features in channels and group chats to work properly. Without it, file uploads in channels or groupa may be silently dropped and generated files will fall back to a web app link.
* Generated files are uploaded to your team's SharePoint so you can open them natively in Microsoft 365.
* Runable only processes messages where you mention @Runable directly. It does not see the surrounding thread or conversation history. Thread context is a planned feature coming soon.

## Next steps

<CardGroup cols={2}>
  <Card title="Connect Telegram" icon="paper-plane" href="/runclaw-telegram">
    Set up Runable in Telegram with slash commands and instant connection.
  </Card>

  <Card title="Connect Slack" icon="slack" href="/runclaw-slack">
    Add Runable to your Slack workspace with channel support.
  </Card>
</CardGroup>
