Overview

Slack MCP enables your application to interact directly with the Slack API. This allows natural language-based clients (ChatGPT, Claude, Cursor, etc.) to perform actions such as sending messages on Slack, retrieving user and channel information, and fetching channel history.

Configuring Settings via Config Manager

1. Log in to the Kuika platform.
2. Open the project you’ll be working on from the Apps screen.
3. Click the Config Manager module in the top menu.

4. To edit an existing configuration, click its name in the list, or create a new configuration using the Create a blank configuration card.
5. Make sure the App Settings tab is selected at the top of the configuration screen.
6. In the left menu, click the MCP option under the INTEGRATIONS heading.
7. Click the Add New link under the Slack section.

8. In the Slack Settings window that opens, fill in the following fields (all fields are required):

• Name: A unique name for this integration.
• BOT Token: The Bot User OAuth Token value for your Slack app (starts with xoxb-). You can retrieve the token from your app’s OAuth & Permissions page in the Slack API dashboard.
• Team ID: The code in your Slack workspace URL that starts with T. For example, in the URL https://app.slack.com/client/T01234567/..., the Team ID is T01234567.

9. Click the Create button.
10. Select the configuration you created from the Slack dropdown menu.
11. Click the Save button in the top-right corner to save your changes. (In an existing configuration, this button appears as Update.)

Creating a Slack BOT Token

1. Go to Slack API Apps.

2. Select the Create an App → From Scratch option.

3. Select App Name and Workspace, then press the Create App button.

4. From the left menu, enter the OAuth & Permissions section.
5. Add the necessary permissions in the Scopes section:
   
   • Minimum: channels:history, channels:read, chat:write, users:read, users.profile:read
   • For Private/DM support: groups:history, groups:read, im:history, im:read, mpim:history, mpim:read

6. Add the app to the Workspace by clicking Install to Workspace → Allow at the top of the page.

7. An Bot Token starting with xoxb-... will be generated on the OAuth & Permissions page.

8. This token and the Team Id found in the URL of the Slack workspace used are entered in the Configuration Manager → Slack Settings field in Kuika.

Action Types

Slack Get Channel History

Retrieves the message history of a specific channel.

Action Input

• settings: Slack settings defined in Config Manager.
• channel_id: Channel ID (e.g., C12345678, G12345678, D12345678).
• limit: How many messages to return (max 1000).

Action Output

• ok → Was the API request successful?
• messages → List of channel messages
• has_more → Are there more messages?

• pin_count → Number of pinned messages in the channel
• channel_actions_count → Number of triggered actions in the channel (e.g., reminder, workflow)
• channel_actions_ts → Timestamp of the last action

Message Details:

• user → User ID who posted the message
• text → Message content
• ts → Timestamp (string float)
• type → Message type (usually “message”)
• subtype → Message subtype (e.g., join, file_share, bot_message)
• bot_id → Bot user ID
• bot_profile → Information about the bot that sent the message (id, name, app_id, icons, team_id)
• blocks → Message structure in Slack Block Kit format

Slack Get User Profile

Retrieves a specific user's profile.

Action Input

• settings: Slack settings.
• user_id: User ID (U12345678).

Action Output

• ok → Was the API request successful?

• profile → User profile details: display_name, real_name, email, title, status_text, status_emoji, phone, image_24, image_192, image_512, image_1024, image_original, always_active, is_custom_image, team, huddle_state, skype

Slack Get Users

Lists all users in the Workspace.

Action Input

• settings: Slack setting.
• cursor: Used for pagination. Left blank for the first query.
• limit: Number of users returned (Default: 100, Max: 200).

Action Output

• ok → Was the API request successful?

• members → User list (id, name, real_name, email, profile images, etc.)
• response_metadata.next_cursor → Cursor for the next page
• cache_ts → Time the response was prepared on the Slack side

User Details

• id, name, real_name, is_admin, is_owner, is_bot, is_email_confirmed
• profile → (display_name, real_name, email, phone, avatar images, status, title)
• tz, tz_label, tz_offset

Slack List Channels

Lists all channels in the Workspace.

Action Input

• settings: Slack setting.
• limit: Number of channels returned (Default: 100, Max: 200).
• cursor: Used for pagination.

Action Output

• ok → Was the API request successful?

• channels → Channel list
  
  • id, name, is_private, is_shared, num_members, creator, created
  • is_member, is_general, is_archived
  • purpose and topic fields (creator, last_set, value)
• response_metadata.next_cursor → Cursor for the next page

Slack Post Message

Sends a message to a specific channel.

Action Input

• settings: Slack settings.
• channel_id: Target channel ID.
• text: Message content.

Action Output

• ok → Was the API request successful?
• channel → Channel ID where the message was sent
• ts → Slack timestamp of the message

• message → Sent message object
  
  • user → Sender user ID
  • text → Message content
  • bot_id → Bot ID (if it's a bot message)
  • bot_profile → Bot information (name, app_id, icons, team_id)
  • blocks → Slack Block Kit content
  • subtype → Subtype (e.g., bot_message)

Usage in Kuika

Slack settings created in Configuration Manager can be used by linking them to the settings parameter in the Slack Action in the project.

Example scenarios:

• List the last 100 messages in a channel → Get Channel History
• Display a specific user's profile → Get User Profile
• List users in the workspace → Get Users
• List all channels → List Channels
• Send a notification to the project channel via the bot → Post Message