Slack MCP Server

An MCP server implementation that integrates the Slack API, providing messaging, channel management, and search capabilities.

Features

• Conversations: List channels, read message history, manage threads

• Messaging: Send, update, and delete messages; add reactions

• Search: Find messages across your workspace (user token only)

• Users: List users, get profiles, lookup by email

• Files & Pins: List files, manage pinned messages

• Token Rotation: Automatic refresh for rotatable tokens

Tools

Conversations

• slack_list_conversations - List channels, DMs, and group DMs

• slack_get_conversation_info - Get channel details

• slack_conversations_history - Fetch message history

• slack_conversations_replies - Get thread replies

• slack_conversations_members - List channel members

• slack_conversations_join - Join a public channel

• slack_conversations_leave - Leave a conversation

• slack_conversations_open - Open 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 emoji reaction

• slack_reactions_remove - Remove emoji reaction

Search

• slack_search_messages - Search messages (requires user token)

Users

• slack_users_list - List workspace users

• slack_users_info - Get user details by ID

• slack_users_lookup_by_email - Find user by email

• slack_auth_test - Get current token info

Other

• slack_team_info - Get workspace info

• slack_bookmarks_list - List channel bookmarks

• slack_pins_list / slack_pins_add / slack_pins_remove - Manage pins

• slack_reminders_list / slack_reminders_add / slack_reminders_delete - Manage reminders

• slack_files_list / slack_files_info - List and get file details

Configuration

Getting a Slack Token

1. Go to Slack API Apps

2. Click Create New App → From scratch

3. Go to OAuth & Permissions

4. Add scopes under Bot Token Scopes or User Token Scopes:

   channels:read, channels:history, chat:write, users:read, team:read

5. Click Install to Workspace

6. Copy the token (xoxb-... or xoxp-...)

Token Types

Development

Install Dependencies

uv sync

Run the Server

uv run python src/main.py

Test the API

uv run python test_api.py

Test with MCP Inspector

npx @modelcontextprotocol/inspector uv run python src/main.py

License

MIT License - see LICENSE for details.