slack-mcp

A Slack MCP server using static bot token authentication via the Dedalus MCP framework.

Setup

1. Create a Slack App at https://api.slack.com/apps

2. Add Bot Token Scopes (see below)

3. Install the app to your workspace

4. Copy the Bot Token (xoxb-...) to your .env file

Tools

Conversations (Channels, DMs, Group DMs)

• slack_list_conversations - List channels, DMs, and group DMs

• slack_get_conversation_info - Get channel/DM details

• slack_conversations_history - Fetch message history from a conversation

• slack_conversations_replies - Get thread replies for a message

• slack_conversations_members - List members of a conversation

• slack_conversations_join - Join a public channel

• slack_conversations_leave - Leave a conversation

• slack_conversations_open - Open or resume a DM or group DM

Messages

• slack_chat_post_message - Send a message to a channel or thread

• slack_chat_update - Update an existing message

• slack_chat_delete - Delete a message

• slack_reactions_add - Add a reaction (emoji) to a message

• slack_reactions_remove - Remove a reaction from a message

Search

• slack_search_messages - Search messages (requires user token xoxp-, not bot token)

Users

• slack_users_list - List all users in the workspace

• slack_users_info - Get user information by ID

• slack_users_lookup_by_email - Find a user by email

• slack_auth_test - Get current user's identity

Team

• slack_team_info - Get workspace information

Bookmarks & Pins

• slack_bookmarks_list - List bookmarks in a channel

• slack_pins_list - List pinned items in a channel

• slack_pins_add - Pin a message to a channel

• slack_pins_remove - Unpin a message from a channel

Reminders

• slack_reminders_list - List reminders

• slack_reminders_add - Create a reminder

• slack_reminders_delete - Delete a reminder

Files

• slack_files_list - List files in the workspace

• slack_files_info - Get file information

Authentication

Set SLACK_BOT_TOKEN environment variable with your bot token (xoxb-...) or user token (xoxp-...).

Required Bot Token Scopes

Add these scopes to your Slack app under "OAuth & Permissions":

• channels:read - View basic channel information

• channels:history - View messages in public channels

• groups:read - View private channels

• groups:history - View messages in private channels

• im:read - View direct messages

• im:history - View DM history

• mpim:read - View group DMs

• mpim:history - View group DM history

• chat:write - Send messages

• reactions:read - View reactions

• reactions:write - Add/remove reactions

• users:read - View users

• users:read.email - View user emails

• team:read - View workspace info

• pins:read - View pinned items

• pins:write - Pin/unpin items

• reminders:read - View reminders

• reminders:write - Create/delete reminders

• files:read - View files

Note: search:read requires a user token (xoxp-), not a bot token.

Local Development

API Reference

• Slack API Methods

• Slack OAuth Scopes