> For the complete documentation index, see [llms.txt](https://docs.flowiseai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flowiseai.com/integrations/langchain/tools/pipedream-mcp-user-guide-1.md).

# Slack MCP

## 1. Prerequisites

Before using the Slack MCP node you need:

* **A Slack account**: sign up at <https://slack.com/>
* **A Slack workspace**
* **An OAuth client app**: generated inside your Slack workspace. This gives you a **Client ID** and **Client Secret**.

***

## 2. Setting Up Slack Credentials

### 2.1 Create a new app in Slack

1. Go to <https://api.slack.com/apps/new>
2. Create a new app, either via manifest or from scratch.

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2Fz4kJ6Wq3a1OtRFQoKqSd%2Fimage.png?alt=media&amp;token=efd3bef0-45e8-4eca-b6bb-4534afb964df" alt=""><figcaption></figcaption></figure>

3. After an app is created, grab the Client ID and Client Secret.

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2FOqkn730Ejoqr7U4mUIEy%2Fimage.png?alt=media&amp;token=8adbcf1a-f9d9-46f9-b206-35c2d31febe1" alt=""><figcaption></figcaption></figure>

### 2.2 Add Credentials in Flowise

1. In Flowise, navigate to **Credentials** from the sidebar.
2. Click **Add Credential** and search for **Slack User Token OAuth2**.
3. Fill in the following fields:

<table><thead><tr><th>Field</th><th>Description</th><th width="250">Example</th></tr></thead><tbody><tr><td><strong>Client ID</strong></td><td>The OAuth Client ID from Slack</td><td><code>wBSGhxxxx</code></td></tr><tr><td><strong>Client Secret</strong></td><td>The OAuth Client Secret (stored securely)</td><td><code>••••••••</code></td></tr><tr><td><strong>Scopes</strong></td><td><em>(Optional)</em> Space-separated scopes.</td><td><p><code>search:read.public search:read.private search:read.mpim search:read.im search:read.files search:read.users groups:history</code></p><p><code>mpim:history</code></p><p><code>im:history</code></p><p><code>channels:history</code></p><p><code>chat:write</code></p><p><code>canvases:read canvases:write</code></p><p><code>users:read</code></p><p><code>users:read.email</code></p></td></tr></tbody></table>

4. Copy OAuth Redirect URL, then click **Save**.

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2FGc5nrQj6xxwcbEeXaqF1%2Fimage.png?alt=media&amp;token=d15b23e8-5497-48fc-8a16-6e03c1958367" alt="" width="548"><figcaption></figcaption></figure>

**Tip:** For production environments, use the narrowest scopes you need. See available [scopes](https://docs.slack.dev/reference/scopes/).

### 2.3 Add Redirect URL to Slack App

1. From the left side nav bar, select OAuth & Permissions:

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2Fwx18HMj55UK2GDSF3qX7%2Fimage.png?alt=media&amp;token=bc44c924-4bcb-4478-bbf7-46e6e7fccb21" alt=""><figcaption></figcaption></figure>

2. Scroll down and you will see Redirect URLs section. Add the copied redirect URL from previous step. Then click Save URLs.

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2FVzmzCeGsYgFvlhY11VyJ%2Fimage.png?alt=media&amp;token=e7d03873-59ce-4dbf-abda-accdd06f5708" alt="" width="563"><figcaption></figcaption></figure>

***

## 3. Adding Slack MCP

1. Drag and drop an Agent node.
2. Add a new Slack MCP tool.

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2F7rNpDOycqUyWTdUTgu4D%2Fimage.png?alt=media&amp;token=42f79f10-e8d4-4419-bcc6-4ff7a21a2348" alt="" width="500"><figcaption></figcaption></figure>

3. Select preconfigured credential, and click the edit button. Click Authenticate.

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2F8lr2h60lsjQpU18GCw5d%2Fimage.png?alt=media&amp;token=335fe702-9530-4281-859f-b28e7ee9e7f1" alt="" width="538"><figcaption></figcaption></figure>

3. A slack pop-up window will appear, review the permissions and click Allow.

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2FN7z4Sx54KNM41NRcW2qg%2Fimage.png?alt=media&amp;token=b4ee039e-622d-45ca-a879-5776e5522c2f" alt="" width="542"><figcaption></figcaption></figure>

4. After authenticated, click the refresh button to load the available actions.

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2F2cwOCrytPot3IJKK70Eq%2Fimage.png?alt=media&amp;token=0ce829cf-f5df-4623-bbec-2d5a2c784dcc" alt=""><figcaption></figcaption></figure>

5. Select the actions. *Tip: Select only the actions your agent needs. Fewer tools help the LLM make better decisions and reduce token usage.*

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2F41oVAfwg96pvzzJyEknD%2Fimage.png?alt=media&amp;token=720fe2fb-6a07-4098-9597-22e446cd6706" alt="" width="452"><figcaption></figcaption></figure>

6. Voila! You can start chatting with the Agent and see how its calling Slack MCP tools.

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2Fs128FrONl2xkjfdTav6V%2Fimage.png?alt=media&amp;token=8446931b-f3ff-4ce9-80be-45cffb6e581c" alt=""><figcaption></figcaption></figure>