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

# Slack integration

> Spawn Murmur agents from Slack by mentioning @Macroscope in a channel or thread.

Mention **@Macroscope** in Slack to start a Murmur agent. The agent reports back in the thread.

## Setup

**1. Connect Slack to Macroscope**

From Macroscope, open [Settings → Connections](https://app.macroscope.com/settings#slack) and add the Slack integration.

**2. Link your Slack profile**

Each teammate links their [Slack profile](https://app.macroscope.com/settings#slack-profile) on the same page, unless your organization allows all Slack users.

**3. Invite @Macroscope to a channel**

Invite **@Macroscope** to the channel, or accept Slack's prompt when you first mention it.

## Spawn agents from Slack

Mention **@Macroscope** (not @Murmur) in a channel or thread and describe the task. The agent replies in the same thread with progress and results.

> [!NOTE]
>
> The Slack integration spawns agents. It doesn't give agents access to search your Slack workspace or use Slack as a tool. To give agents access to tools like that, use workspace [secrets](https://docs.murmur.dev/concepts/secrets.md) or [plugins](https://docs.murmur.dev/integrations/mcp.md#give-agents-other-mcp-servers).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.