# Slack (Official)

**Type:** Official

**Source Type:** Remote URL

**Description:** Slack (Remote) MCP server provides AI assistants with access to Slack's communication platform via Slack's native remote MCP integration. It enables reading and sending messages, managing channels, and interacting with users through OAuth authentication.

{% hint style="info" %}
Slack's remote MCP server requires a Slack App with OAuth configured. The app must be either an internal app or published to the Slack App Directory — unlisted apps are not permitted to use MCP.
{% endhint %}

***

## Setup

### Part 1: Create a New Slack App

1. Navigate to <https://api.slack.com/apps>.
2. Click **Manage Apps** in the top navigation bar, then **Create New App**.
3. Select **From Scratch** to manually configure the app.
4. Name the app and select the workspace where you want to install it.
5. Click **Create App**.

### Part 2: Enable Model Context Protocol

1. In the left sidebar, click **Agents & AI Apps**.
2. Locate the **Model Context Protocol** toggle and turn it on.

### Part 3: Configure OAuth & Permissions

1. In the left sidebar, click **OAuth & Permissions**.
2. Under **Redirect URLs**, click **Add New Redirect URL** and enter:

{% hint style="warning" %}
Use exactly this redirect URL — the OAuth flow will fail if it doesn't match.
{% endhint %}

```
https://api.natoma.app/mcp/server/callback
```

3. Click **Add**, then **Save URLs**.
4. Under **Scopes**, add at least one Bot Scope — e.g., `channels:read` or any other scopes needed by your organization.

{% hint style="info" %}
This server does not operate as a bot, but requires at least one bot scope to complete the initial OAuth install.
{% endhint %}

### Part 4: Connect Slack to Natoma

1. In Natoma, click **Apps** in the left sidebar and find **Slack (Remote)**.
2. Click **+** > **Enable Personal Connections**.
3. In the dialog, copy the **Client ID** and **Client Secret** from your Slack app's **Basic Information** page and paste them into Natoma.
4. Add the minimum required scopes: `openid`, `profile`, `email`.
5. Click **Continue**.

### Part 5: Authorize and Test the Connection

1. In Natoma, click **My Connections** in the left sidebar.
2. Click **+ Add Personal Connection** next to **Slack (Remote)**.
3. Click **Authorize** to begin the OAuth flow.
4. Review the permissions in Slack and click **Accept and Continue**.
5. Once redirected back to Natoma, click **Test Connection** to verify everything is working.

If the connection test is successful, you will see a confirmation message and a list of available tools.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.natoma.ai/apps/slack-remote.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.