1#### Use Grok Bot
2
3# Team Bots
4
5A Bot is either personal or a Team Bot. Share a Bot the way you'd share a doc:
6with your Cursor team, your whole organization, or only certain people and
7groups. Sharing doesn't make a copy, and each person's chat with a Team Bot is
8private.
9
10Team Bots always run in the cloud. A Bot that runs on your own computer can't
11be shared. A few screens, such as **Browse shared Bots**, still say Team Bots.
12They're the same thing.
13
14## Who can use Team Bots?
15
16Team Bots are available on Team and Enterprise plans, for members who have Grok
17Bot. Choose **+** in
18the sidebar to see **Create a Bot** and **Browse shared Bots**. If **Browse
19Team Bots** isn't there, you aren't on a Cursor team, or your Grok Bot app
20needs an update.
21
22In Slack, members of your workspace who aren't on the team can sometimes use a
23Team Bot too. See [Who can talk to a Team Bot in
24Slack?](#who-can-talk-to-a-team-bot-in-slack)
25
26## How do I create a Bot for my team?
27
281. Choose **+** in the sidebar, then **Create a Bot**, and give it a name.
292. Tell the Bot what it should help the team with. A sentence is enough.
303. Follow its setup steps for apps, secrets, skills, and files. Only add keys
31 and files you're happy for everyone you share it with to use. Until you
32 publish it, it's a draft only you can see.
334. When the Bot says it's ready to share, choose **Publish**. Teammates can
34 then find it. To change who has access, see [How do I share a Bot with my
35 team?](#how-do-i-share-a-bot-with-my-team)
36
37You can also share a Bot you already have. Sharing doesn't duplicate it. Before
38you share, check its apps, secrets, skills, and files, since they work in every
39teammate's chat.
40
41## How do I share a Bot with my team?
42
43Choose **Share** at the top right of the Bot's chat. In **Share this Bot**:
44
45* Under **Who has access**, choose your team to share the Bot with everyone on
46 the team. If your team is part of an organization, choose the organization
47 to share it with everyone in it. Choose **People you invite** to share it only with the people
48 and groups you add. Limiting it asks you to confirm with **Limit access**.
49 The owner and Managers can always use the Bot.
50
51* Search under **Add people or groups** to add someone. People you add can chat
52 with the Bot as a **Collaborator**. In the list of people who have access,
53 open a person's role and choose **Manager** to let them also change how the
54 Bot works and share it with others.
55
56* Choose **Copy link** to send teammates a link to the Bot.
57
58To stop sharing, the owner can choose **Only you** under **Who has access**.
59This removes everyone else after you confirm with **Remove**. To remove one
60person or group, open their role in the list and choose **Remove**.
61
62## Who can share Bots?
63
64Anyone on the team, unless an admin changes it. On the Grok Bot page of the team
65dashboard, **Bot sharing** under **Sharing** is set to **Everyone** or **Admins
66only**. With **Admins only**, **Share** is disabled for members and shows **Only
67team admins can share Bots**. Bots that were already shared stay shared, and
68their owners and Managers can still use them. Ask an admin to share a Bot for
69you, or to change the setting. See [How do admins manage Team
70Bots?](#how-do-admins-manage-team-bots)
71
72## How do teammates find a Team Bot?
73
74* Choose **+** in the sidebar, then **Browse shared Bots**. The list shows Bots
75 shared with you, and each one shows who made it. Choose **Add** to keep a Bot
76 in your sidebar.
77* In the desktop app, press `Cmd/Ctrl+K` and choose **Browse shared Bots**.
78 The list starts with **Popular** Bots, and you can search it. You can also
79 type a Team Bot's name and choose it to add it.
80* Ask one of your Bots in your own chat, for example "Is there a Team Bot
81 for on-call triage?" It searches the Team Bots you can use by what they do,
82 and tells you which ones you've already added.
83* On your phone, tap **+**, then **Browse shared Bots**.
84* Open a link a teammate sent you, then choose **Start a chat**.
85
86A Team Bot's link opens the same Bot for everyone. It's different from
87[sharing a Bot template](/grok-bot/bots#share-a-bot), which gives each person
88their own copy.
89
90## Can the owner see my chats with a Team Bot?
91
92No. Each person's chat with a Team Bot is private. The owner and Managers
93can't read your chats, and you can't read the owner's or anyone else's.
94
95The Bot can learn things for the whole team. What it learns from a teammate
96waits until the owner or a Manager approves it under **Review learnings**. It
97doesn't save anything about you personally for the team. What it remembers
98about working with you stays between you and the Bot. See [What does a Team Bot
99learn for the team?](#what-does-a-team-bot-learn-for-the-team)
100
101## What does a Team Bot learn for the team?
102
103A Team Bot keeps team memory and skills that everyone who uses it benefits
104from. When a teammate teaches it something for the team, such as a better way
105to do a task, the Bot suggests the change instead of saving it straight away.
106
107* Suggested memory and skill changes wait until the owner or a Manager approves
108 them. Owners and Managers see **Review learnings**, with the number waiting,
109 under **Suggested** in the Bot's details. Each one says what it does, such as
110 **Updates the skill** or **Forgets a team memory**, with **Approve** and
111 **Reject**.
112* Changes the owner or a Manager makes in the Bot's main chat apply right away.
113
114What the Bot learns about you personally stays between you and the Bot. It
115isn't saved for the team.
116
117## Whose apps and secrets does a Team Bot use?
118
119A Team Bot uses the apps and secrets its owner added. Those work the same for
120everyone who chats with it.
121
122In your own chat with a Team Bot, it can also use your apps. It asks before it
123uses one of your personal accounts. The card says **Allow**, then the app name:
124
125* **Allow once** lets it use that account this time.
126* **Always allow** remembers your answer. Its menu has **Always allow for your
127 messages to this Bot** and **Always allow for your messages to every Team
128 Bot**.
129* **Skip** means it doesn't use that account this time.
130
131In Slack channels, threads, and group chats, a Team Bot uses only its owner's
132apps, and asks before it uses your accounts.
133
134A connected account acts as the person the Bot is answering. One teammate's
135connection is never used for someone else, unless a Manager shares it as a
136shared connector.
137
138To make every Team Bot ask again, open **Settings** > **General** > **Team
139Bots** and choose **Clear** next to **Clear connector preferences**.
140
141## How do shared connectors work?
142
143A shared connector lets everyone use an app through one account, so teammates
144don't each have to connect it. The owner or a Manager sets it up: open the
145Bot's details and, under **Setup**, choose **Service accounts**. Pick an app
146under **Shared connectors**, then choose how the Bot signs in to it:
147
148* **Use individual accounts**: each teammate connects their own.
149* **Share your account**: everyone who uses the Bot acts through your account,
150 including to make changes. Connect the app for yourself first, and only share
151 an account that holds nothing sensitive or private.
152* The Bot's own account: a separate account the Bot uses for the team. Some
153 apps don't support this yet.
154
155Sharing your account needs a team admin to turn on **Allow Shared Logins**
156first. Until then, the Bot says **Your admin has turned off sharing logins with
157Bots**. See [How do admins manage Team Bots?](#how-do-admins-manage-team-bots)
158
159The app's row shows whose account the Bot uses. To stop, choose **Stop
160sharing**, or remove the app. Teammates then connect their own.
161
162## Which computer does a Team Bot use?
163
164In your own chat with a teammate's Team Bot, the Bot usually works on your
165Grok Bot computer. That means it can use the files there and the sites you're
166signed in to there. Sometimes it uses a separate computer just for that
167conversation, for example when your privacy mode is stricter than the owner's.
168
169When you DM a Team Bot in Slack, it also works on your own computer. In Slack
170channels, threads, group DMs, and group chats, a Team Bot uses one shared
171computer of its own.
172
173## Whose usage pays for a Team Bot chat?
174
175A Team Bot reply uses the Grok Bot usage of the person it's answering. That's
176true in your own chat, in Slack, and in group chats. Your own limits apply. The
177owner's usage pays for the owner's own messages, and for Slack posts from apps
178or workflows that aren't linked to a Cursor account. A reply to someone in
179Slack who hasn't linked an account or isn't on the team uses the team's usage.
180See [How much does Grok Bot
181cost?](/grok-bot/faq#how-much-does-grok-bot-cost)
182
183## How do approvals work on a Team Bot?
184
185A Team Bot asks the person it's answering before risky actions.
186
187* In your own chat with a Team Bot, you answer its approval cards.
188* In a Slack thread, the Bot posts a **Review an action** card with **Allow
189 once**, **Deny**, and **View details**. Only the person who asked can answer
190 it.
191* In a group chat, only the person whose message the Bot is answering can
192 answer.
193
194It also asks before it uses your personal accounts. See [Whose apps and secrets
195does a Team Bot use?](#whose-apps-and-secrets-does-a-team-bot-use) For the
196rest of the approval model, see [Approvals, security, and
197privacy](/grok-bot/approvals-security-and-privacy).
198
199## How do I add a Team Bot to Slack?
200
201The owner or a Manager adds it, after sharing:
202
2031. Open the Bot's details, or choose **Manage** and look under **Channels**.
2042. Find **Bring to your team's Slack** or **Slack**, and choose **Connect**.
2053. If it says **Awaiting admin approval**, a Slack workspace admin needs to
206 approve the app.
207
208Once it says **Connected**, teammates can message the Bot directly or mention it
209in channels.
210
211In a channel thread or a DM, the Team Bot acts for the teammate who mentioned
212it. It can hand work to that person's own Bots, and their replies are posted
213back into the same thread. A personal Bot doesn't hand work to other Bots from a
214channel thread. See [Let Bots hand work
215off](/grok-bot/chat-and-collaboration#let-bots-hand-work-off).
216
217Bots record who asked for each message they post in Slack, so anyone in the
218thread can ask the Bot who requested it. When a Team Bot's routine replies in a
219Slack thread, the Bot follows that thread and answers later replies without an
220@mention.
221
222Link your Slack account so the Bot knows who you are and can use your apps.
223Open **Settings** > **General** > **Team Bots** and choose **Link**. If you
224message the Bot before you link, it replies with steps to link your account.
225
226## Who can talk to a Team Bot in Slack?
227
228It depends on who the Bot is shared with.
229
230* **Your organization**: any full member of your Slack workspace can mention it
231 in channels and threads, even without a linked account or a seat on your
232 team. Without a linked account, they're told once per thread that **some
233 features will be limited**. In a DM, they still need to link first. The same
234 goes for a Bot shared with your team when the team isn't in an organization,
235 or is the only team in it.
236* **Your team, or certain people**: only people it's shared with. A linked
237 teammate without access is told the Bot **hasn't been shared with you yet**.
238 Add them under **Share this Bot**. Someone without a linked account is asked
239 to link one.
240* **A personal Bot** only chats with its owner.
241
242Slack guests, Slack Connect channels, and other Slack workspaces are never
243included. If your Slack email matches an account that already has access, the
244Bot asks you to link it instead.
245
246A team admin can turn this off for workspace members who aren't on the team.
247See [How do admins manage Team Bots?](#how-do-admins-manage-team-bots)
248
249## How do I add a Team Bot to Microsoft Teams?
250
251A team admin turns on Microsoft Teams for the team first. Then the owner or a
252Manager connects the Bot from its details under **Bring to your team's
253Microsoft Teams**, and a Microsoft Teams admin approves it. The full steps,
254what the Bot can do there, and what to do when it isn't in Teams yet are on
255[Use Grok Bot in Microsoft Teams](/grok-bot/microsoft-teams).
256
257## How do I edit or delete a Team Bot?
258
259The owner and the Bot's Managers can change a Team Bot. Its details show in
260the panel on the right of the chat:
261
262* **Plugins** (the Bot's connected apps), **Secrets**, **Skills**, and
263 **Files** hold what the Bot uses for everyone.
264* Click the name to rename the Bot. Edit the description under **About**.
265* **Share** controls who can use the Bot and who manages it.
266
267Choose the wrench, **Manage**, for the rest:
268
269* **General** has the Bot's settings, such as whether Collaborators can set up
270 routines, its channels such as Slack and Microsoft Teams, and the **Bot's
271 accounts** it signs in to apps with.
272* **Knowledge** shows what the Bot learned for everyone, and its skills. New
273 learnings wait under **To review** until you choose **Approve** or
274 **Reject**.
275* **Analytics**, when shown, has the Bot's messages, hours saved, and top users.
276
277The owner can also rename the Bot by right-clicking it in the sidebar and
278choosing **Rename Bot**.
279
280Only the owner can delete a Team Bot. Right-click the Bot in the sidebar and
281choose **Delete**. A team admin can also delete it from **Manage Bots** in the
282dashboard. This deletes the Bot for your whole team. Teammates lose it,
283along with their chats and routines on it. It can't be undone.
284
285## How do I remove a Team Bot from my sidebar?
286
287Right-click the Bot and choose **Remove from sidebar**. To add it back, choose
288**+** in the sidebar, then **Browse shared Bots**, and choose **Add** next to
289it.
290
291If your admin added the Bot to your sidebar for you, **Remove from sidebar**
292isn't in its menu, and you can't remove it.
293
294## Can I use Team Bots on my phone?
295
296Yes. Team Bots you've added appear in the [phone app](/grok-bot/mobile). To
297find another, tap **+**, then **Browse shared Bots**. Each Bot in the list
298shows how many people use it, and **Add** keeps it in your list. You can chat
299with Team Bots and answer their **Allow** cards. A Team Bot can't be your
300[primary Bot](/grok-bot/bots#your-primary-bot).
301
302To remove a teammate's Bot from your list, touch and hold it and choose
303**Remove from sidebar**.
304
305The owner and Managers can also manage a Team Bot from its profile on the
306phone:
307
308* **Share** opens **Share this Bot**, where you choose who has access and add
309 people. If you're on more than one team, choose a team before you share.
310* **Tools** has the Bot's service accounts, and **Slack** adds the Bot to Slack
311 with your own Slack connection. See [How do I add a Team Bot to
312 Slack?](#how-do-i-add-a-team-bot-to-slack)
313* **Skills** lists the Bot's skills. Tap **+** to choose **Add Custom Skill**
314 or **Import Existing Skill**, and open a skill to edit it and choose **Save
315 changes**.
316* **Learnings** shows how many learnings are waiting, for example "3 to
317 review". Choose **Approve** or **Reject** on each one.
318* **Routines** lists the Bot's routines, with **Add routine** and the
319 **Collaborators can create routines** switch.
320* **Analytics**, when shown, has weekly and daily active users, messages, hours
321 saved, and top users, over **7 days**, **30 days**, or **90 days**.
322
323When you ask one of your own Bots on the phone to work with your team, it shows
324a **Team access** card. **Share** moves that Bot to the team with its chat and
325memories, or **Copy** makes a team copy and keeps the original private. **Start
326fresh** creates a new Team Bot without this chat or its memories.
327
328## Can I voice chat with a teammate's Team Bot?
329
330Yes, on desktop. In your own chat with the Bot, choose **Start voice chat**. See
331[Start a voice chat](/grok-bot/chat-and-collaboration#start-a-voice-chat).
332
333## Can a Team Bot join a group chat?
334
335Yes. You can add a Bot a teammate shared with you to your own group chat. It
336can't share a group with Bots that run on your own computer. See [Start a group
337chat](/grok-bot/chat-and-collaboration#start-a-group-chat).
338
339## How do admins manage Team Bots?
340
341On the Grok Bot page of the [Cursor dashboard](https://cursor.com/dashboard/bot),
342open **Manage Bots** under **Shared Bots**.
343
344* **Access** shows who can use each Team Bot. Click it to change who can use
345 the Bot.
346* **Auto-add** puts the Bot in members' sidebars automatically. Pick **All
347 team** or one or more groups. Those members can't hide it. Auto-add only
348 applies to groups that have access.
349* Admins can also delete a Team Bot here.
350
351Under **Sharing** on the same page:
352
353* **Bot sharing** decides who may share Bots: **Everyone** or **Admins only**.
354 Bots already shared stay shared.
355* **Allow Shared Logins** lets Managers share their own app logins as [shared
356 connectors](#how-do-shared-connectors-work). Everyone who uses the Bot then
357 acts through that Manager's account. It's off by default.
358* **Slack Workspace Access** lets members of your Slack workspace who aren't on
359 the team use Bots shared with your organization. It's on by default, and in
360 an organization it applies to every team. The setting appears as it reaches
361 your team.
362
363See [Grok Bot for teams and
364enterprises](/grok-bot/teams-and-enterprises#manage-bots).
365
366## Why can't I see or use a Team Bot?
367
368| What you see | What it means |
369| --- | --- |
370| **Browse shared Bots** isn't under **+** | You aren't on a Cursor team, or your Grok Bot app needs an update. |
371| **Team Bots Not Available** | Your account doesn't have access to Team Bots. |
372| **Only team admins can share Bots** | Your team admin limited Bot sharing to admins. **Share** is disabled, and the message appears when you hover it. Ask an admin to share the Bot for you, or to change **Bot sharing** on the team dashboard. |
373| **Bot Not Found** | The Bot may have been removed, or it isn't shared with you. |
374| **No Access to This Bot** | The Bot is shared only with certain people. Ask its owner or a Manager for access. |
375| A teammate's Bot isn't in **Browse shared Bots** | The owner hasn't shared it with you yet. |
376| **Your usage limit has been reached** | Your Grok Bot usage ran out. Your chats with a teammate's Team Bot use your usage. See [How much does Grok Bot cost?](/grok-bot/faq#how-much-does-grok-bot-cost) |
377| **This Bot's owner has reached their usage limit** | This reply was billed to the owner's account, and the owner's usage ran out. Ask the owner to check their plan. |
378| **This conversation can't run on your computer because your privacy mode is stricter than the bot owner's.** | Your privacy mode setting is stricter than the owner's, so this chat can't use your computer. |
379| In Slack, the Bot asks you to link a Cursor account | Link your Slack account under **Settings** > **General** > **Team Bots**, using the Cursor account on the Bot's team. |
380| In Slack, **some features will be limited** | The Bot answered you without a linked account. Link one so it knows who you are and can use your apps. |
381| In Slack, **I haven't been shared with you yet** | Ask the Bot's owner or a Manager to add you under **Share this Bot**. |
382| In Slack, the Bot says it's someone's personal Bot | Only its owner can talk to it. |
383| **Your admin has turned off sharing logins with Bots** | A team admin needs to turn on **Allow Shared Logins** before a Manager can share an account as a shared connector. |
384
385If none of these match, [contact support](/grok-bot/troubleshooting) with the
386Bot's name, the exact message, and your Grok Bot version.
387
388## Related pages
389
390* [Use Grok Bot in Microsoft Teams](/grok-bot/microsoft-teams)
391* [Add a Bot to your meetings](/grok-bot/meetings)
392* [Create and manage Bots](/grok-bot/bots)
393* [Message and collaborate](/grok-bot/chat-and-collaboration)
394* [Use the computer and apps](/grok-bot/computer-and-apps)
395* [Vault and secure sign-in](/grok-bot/vault)
396* [Approvals, security, and privacy](/grok-bot/approvals-security-and-privacy)
397* [Grok Bot for teams and enterprises](/grok-bot/teams-and-enterprises)
398* [Troubleshooting](/grok-bot/troubleshooting)
