> 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-community.md).

# Slack Community

**Type:** Built by Natoma

**Source Type:** Repository

**Description:** Slack Community MCP server provides AI assistants with access to Slack's communication platform using OAuth authentication and Natoma's hosted server image. It enables reading and posting messages, managing channels, searching conversations, and interacting with users.

***

## Setup

### Admin Setup (one-time)

1. Navigate to <https://api.slack.com/apps>.
2. Click **Create New App** > **From Scratch**, name the app, and select your workspace.
3. In the left sidebar, click **OAuth & Permissions**.
4. 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
```

5. Click **Add**, then **Save URLs**.
6. Under **Scopes → User Token Scopes**, add the scopes needed by your organization. Starter set:

```
channels:history
channels:read
chat:write
groups:history
groups:read
search:read
users:read
```

7. Under **Install App**, click **Install to Workspace** and approve the requested scopes.
8. From **Basic Information**, copy the **Client ID** and **Client Secret**.

In Natoma, an admin adds **Slack Community** under **Apps** and enters the **Client ID** and **Client Secret**.

### Authorize Your Connection

When prompted while creating the connection in Natoma, click **Authorize**.
