Slack User MCP Server

🚀 Slack User MCP Server

An MCP server for the Slack API that enables Claude to access user data.

🚀 Quick Start

This is an MCP server for the Slack API, allowing Claude to access user data.

✨ Features

1. Get All Public Channels

• Function: Returns all public channels in the team.
• Input Parameters:
  • page (optional): Pagination cursor, default is "0".
• Return Value: An array containing channel IDs and names.

2. Get User Information

• Function: Returns detailed information about the current user.
• Input Parameters: None.
• Return Value: User ID, email, and display name.

3. Get Message History

• Function: Returns the message history in the specified channel.
• Input Parameters:
  • channel_id (required): The ID of the channel to retrieve messages from.
  • page (optional): Pagination cursor, default is "0".
• Return Value: A list of messages, each containing the sender, timestamp, and content.

4. Send Message

• Function: Sends a new message to the specified channel.
• Input Parameters:
  • channel_id (required): The ID of the channel to receive the message.
  • message (required): The content of the message to send.
• Return Value: Success confirmation or error message.

📦 Installation

Using Docker

docker build -t mcp/slack-user -f src/slack/Dockerfile .

Example Run Configurations

Local Installation

{
  "mcpServers": {
    "slack": {
      "command": "run",
      "args": [
        "--prefix",
        "/path/to/slack-user-mcp",
        "start"
      ],
      "env": {
        "SLACK_TOKEN": "xoxp-your-user-token",
        "SLACK_TEAM_ID": "T01234567"
      }
    }
  }
}

Using npx

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-slack-user"
      ],
      "env": {
        "SLACK_TOKEN": "xoxp-your-user-token",
        "SLACK_TEAM_ID": "T01234567"
      }
    }
  }
}

Docker Run

docker run -i --rm -e SLACK_TOKEN -e SLACK_TEAM_ID mcp/slack-user

📚 Documentation

Troubleshooting

• Permission Errors: Ensure that the Slack app is correctly configured with all required permissions.
• Installation Issues: Confirm that the app is successfully installed in the workspace.
• Token Issues: Use a valid user OAuth token (starting with xoxp-), not a bot token.

📄 License

This MCP server is released under the MIT License. You are free to use, modify, and distribute the software under the terms of the MIT License. For more details, please refer to the LICENSE file in the project repository.