slack-mcp

# 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](https://api.slack.com/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 | Token | Prefix | Search? | Access | |-------|--------|---------|--------| | Bot | `xoxb-` | No | Invited channels only | | User | `xoxp-` | Yes | All user's channels | | Rotatable | `xoxe.xoxp-` | Yes | Auto-refreshes | ## Development ### Install Dependencies ```bash uv sync ``` ### Run the Server ```bash uv run python src/main.py ``` ### Test the API ```bash uv run python test_api.py ``` ### Test with MCP Inspector ```bash npx @modelcontextprotocol/inspector uv run python src/main.py ``` ## License MIT License - see [LICENSE](LICENSE) for details.