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


---

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