# Slack

> Install the Done Bear Slack bot to keep tasks moving from Slack conversations.

Bring Done Bear into Slack so your team can turn conversations into tasks without switching tools.

## Overview

Ask `@Done Bear` to create a task, clarify a thread, or answer Done Bear task questions in a Slack channel, thread, or DM. Done Bear replies in-thread.

## Configure

### Integration setup

Open **Done Bear Settings → Integrations → Slack** and choose **Add to Slack**. A Done Bear workspace owner or admin starts the install, then a Slack workspace admin or app manager approves the app for the Slack workspace. After that, people in the workspace can:

- Ask `@Done Bear` to create Done Bear tasks from Slack channels and threads.
- DM `@Done Bear` to create personal capture tasks or ask about your tasks.
- Invite `@Done Bear` to private channels before mentioning it there.
- Read the in-thread reply to confirm the task title and the view it landed in.

### Connect multiple Slack workspaces

Done Bear is designed for one Slack app with multiple workspace installations. Each Slack workspace installs the same Done Bear Slack app and maps to one Done Bear workspace.

## Done Bear Agent For Slack

Mention `@Done Bear` in a discussion and ask it to create a task. Done Bear uses the Slack thread as context and only creates a task when the message is asking for one.

For example:

- `@Done Bear create a task to follow up with support`
- `@Done Bear create a task to review this bug report`
- `@Done Bear add a todo for the launch checklist`

Slack replies are posted in-thread.

To use `@Done Bear` in Slack:

- **Public channels:** mention `@Done Bear` directly.
- **Private channels:** invite the bot first with `/invite @Done Bear`.
- **Direct messages:** DM `@Done Bear` with a task request.
- **Group DMs:** invite the bot when creating the group DM.

## Create tasks from messages

Mention or DM `@Done Bear` with a clear task request. The task is created in the Done Bear workspace connected by the installer, and lands in Today unless you name another view or give it a date.

Mentioning the bot is how you reach it. Done Bear does not appear in Slack's **More actions** menu.

## Thread context

Mention `@Done Bear` in a thread and it reads the surrounding replies, then creates or updates tasks from what it finds there. Point it at the part you want captured and it works from that context rather than the single message you wrote.

Slack threads and Done Bear task comments are separate places. A reply you post in Slack stays in Slack, and a comment you write on a task stays on the task.

## Replies

Done Bear answers in the thread where you mentioned it, and posts nothing otherwise. There are no team, project, or personal Slack notifications, so nothing from Done Bear reaches a channel unless someone asked it to.

## Try it

After the bot is installed, try:

```text
@Done Bear create a task to review the Slack bot
```

## Setup Notes For Admins

The Slack app uses Slack OAuth for workspace installation. Done Bear stores an encrypted bot token and maps the Slack workspace to your Done Bear workspace. The Done Bear agent handles Slack messages through the same MCP tools used by the app assistant.

Only people whose Slack email matches a member of the connected Done Bear workspace can use the bot; everyone else gets a short refusal instead of a task. Every task the bot creates is written by the Done Bear account that installed the integration, whoever asked for it.

The app needs Slack permissions for app mentions, direct messages, reading the sender's profile email, and posting replies.

## Troubleshooting

| Problem                             | Fix                                                                                                                            |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| The bot does not answer DMs         | Reconnect Slack from Done Bear settings. Installs older than the `im:history` scope need it.                                   |
| Mentions do not trigger             | Invite the bot to the channel, then mention it again.                                                                          |
| The bot says it cannot verify you   | Your Slack email has to match a member of the connected Done Bear workspace. Ask an admin to invite you, then reconnect Slack. |
| The task appears under another user | Every Slack-created task is written by the account that installed the integration.                                             |

---

Every Done Bear page is listed at https://donebear.com/llms.txt. Any page has a markdown copy at its URL plus `.md`. Start from the map rather than guessing a path.