> For the complete documentation index, see [llms.txt](https://docs.natoma.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.natoma.ai/apps/slack-remote.md).

# 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.
