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

# Slack

> Set up the Slack resource in Python.

## Dependencies

No additional dependencies - uses `aiohttp` (included).

For credential setup, see the [Slack Setup](/home/setup/slack) guide.

## Configuration

```python theme={null}
import os

from mirage import MountMode, Workspace
from mirage.resource.slack import SlackConfig, SlackResource

config = SlackConfig(
    token=os.environ["SLACK_BOT_TOKEN"],
    search_token=os.environ.get("SLACK_USER_TOKEN"),
)
resource = SlackResource(config=config)
ws = Workspace({"/slack/": resource}, mode=MountMode.READ)
```

## Config Reference

| Field          | Required | Description                                                   |
| -------------- | -------- | ------------------------------------------------------------- |
| `token`        | Yes      | Slack Bot User OAuth Token (`xoxb-...`)                       |
| `search_token` | No       | User OAuth Token (`xoxp-...`) with `search:read`; search only |