Version: 0.0.1

MCP Server CLI Reference

The Slack MCP Server provides a comprehensive command-line interface for starting and configuring the server. This reference covers all available CLI options, usage patterns, and examples.

Basic Usage

The MCP server can be started using multiple execution methods:

Console Script
Python Module
Poetry
UV

# After installation via pip/uv/poetry
slack-mcp-server [OPTIONS]

# Using Python directly
python -m slack_mcp.mcp [OPTIONS]

# Using Poetry in development
poetry run slack-mcp-server [OPTIONS]

Or use poetry to run the module directly:

poetry run python -m slack_mcp.mcp [OPTIONS]

# Using UV package manager
uv run slack-mcp-server [OPTIONS]

Or use uv to run the module directly:

uv run python -m slack_mcp.mcp [OPTIONS]

Command Options

Transport Options

`--transport`

Type: Choice
Choices: stdio, sse, streamable-http
Default: stdio
Description: Specifies the transport protocol for MCP communication.

Console Script
Python Module
Poetry
UV

slack-mcp-server --transport stdio
slack-mcp-server --transport sse
slack-mcp-server --transport streamable-http

python -m slack_mcp.mcp --transport stdio
python -m slack_mcp.mcp --transport sse
python -m slack_mcp.mcp --transport streamable-http

poetry run slack-mcp-server --transport sse
poetry run python -m slack_mcp.mcp --transport sse

uv run slack-mcp-server --transport sse
uv run python -m slack_mcp.mcp --transport sse

Transport Details:

stdio: Communicates via standard input/output streams. Best for desktop applications and CLI integrations.
sse: Server-Sent Events over HTTP. Ideal for web applications and real-time streaming.
streamable-http: HTTP-based streaming protocol. Suitable for REST API integrations and microservices.

Network Options

`--host`

Type: String
Default: 127.0.0.1
Description: Host interface to bind the server (HTTP transports only).

Console Script
Python Module
Poetry
UV

slack-mcp-server --transport sse --host 127.0.0.1
slack-mcp-server --transport sse --host 0.0.0.0
slack-mcp-server --transport sse --host 192.168.1.100

python -m slack_mcp.mcp --transport sse --host 127.0.0.1
python -m slack_mcp.mcp --transport sse --host 0.0.0.0
python -m slack_mcp.mcp --transport sse --host 192.168.1.100

poetry run slack-mcp-server --transport sse --host 0.0.0.0

uv run slack-mcp-server --transport sse --host 0.0.0.0

Security Note: Use 0.0.0.0 only in containerized environments or when you need external access. For local development, prefer 127.0.0.1.

`--port`

Type: Integer
Default: 3001
Range: 1-65535
Description: Port number for HTTP transports.

Console Script
Python Module
Poetry
UV

slack-mcp-server --transport sse --port 3001
slack-mcp-server --transport sse --port 8080
slack-mcp-server --transport sse --port 0  # Auto-assign available port

python -m slack_mcp.mcp --transport sse --port 3001
python -m slack_mcp.mcp --transport sse --port 8080
python -m slack_mcp.mcp --transport sse --port 0  # Auto-assign available port

poetry run slack-mcp-server --transport sse --port 8080

uv run slack-mcp-server --transport sse --port 8080

`--mount-path`

Type: String
Default: /mcp
Description: Mount path for SSE transport endpoints.

Console Script
Python Module
Poetry
UV

slack-mcp-server --transport sse --mount-path /mcp
slack-mcp-server --transport sse --mount-path /api/v1/mcp
slack-mcp-server --transport sse --mount-path /

python -m slack_mcp.mcp --transport sse --mount-path /mcp
python -m slack_mcp.mcp --transport sse --mount-path /api/v1/mcp
python -m slack_mcp.mcp --transport sse --mount-path /

poetry run slack-mcp-server --transport sse --mount-path /api/v1/mcp

uv run slack-mcp-server --transport sse --mount-path /api/v1/mcp

Logging Options

`--log-level`

Type: String
Choices: DEBUG, INFO, WARNING, ERROR, CRITICAL
Default: INFO
Description: Sets the logging verbosity level.

Console Script
Python Module
Poetry
UV

slack-mcp-server --log-level DEBUG
slack-mcp-server --log-level INFO
slack-mcp-server --log-level ERROR

python -m slack_mcp.mcp --log-level DEBUG
python -m slack_mcp.mcp --log-level INFO
python -m slack_mcp.mcp --log-level ERROR

poetry run slack-mcp-server --log-level DEBUG

uv run slack-mcp-server --log-level DEBUG

Log Level Details:

DEBUG: Detailed diagnostic information. Use for development and troubleshooting.
INFO: General informational messages. Good for production monitoring.
WARNING: Warning messages for potentially problematic situations.
ERROR: Error messages for serious problems.
CRITICAL: Critical error messages for fatal problems.

Connection Options

`--timeout`

Type: Integer
Default: 30
Unit: Seconds
Description: Request timeout for Slack API calls.

Console Script
Python Module
Poetry
UV

slack-mcp-server --timeout 30
slack-mcp-server --timeout 15
slack-mcp-server --timeout 60

python -m slack_mcp.mcp --timeout 30
python -m slack_mcp.mcp --timeout 15
python -m slack_mcp.mcp --timeout 60

poetry run slack-mcp-server --timeout 30
poetry run python -m slack_mcp.mcp --timeout 30

uv run slack-mcp-server --timeout 30
uv run python -m slack_mcp.mcp --timeout 30

`--max-retries`

Type: Integer
Default: 3
Range: 0-10
Description: Maximum number of retry attempts for failed requests.

Console Script
Python Module
Poetry
UV

slack-mcp-server --max-retries 3
slack-mcp-server --max-retries 0
slack-mcp-server --max-retries 5

python -m slack_mcp.mcp --max-retries 3
python -m slack_mcp.mcp --max-retries 0
python -m slack_mcp.mcp --max-retries 5

poetry run slack-mcp-server --max-retries 3
poetry run python -m slack_mcp.mcp --max-retries 3

uv run slack-mcp-server --max-retries 3
uv run python -m slack_mcp.mcp --max-retries 3

Usage Examples

Development Environment

Console Script
Python Module
Poetry
UV

# Recommended for development
slack-mcp-server \
  --transport stdio \
  --log-level DEBUG

slack-mcp-server \
  --transport sse \
  --host 127.0.0.1 \
  --port 3001 \
  --log-level DEBUG

# Direct Python execution
python -m slack_mcp.mcp \
  --transport stdio \
  --log-level DEBUG

python -m slack_mcp.mcp \
  --transport sse \
  --host 127.0.0.1 \
  --port 3001 \
  --log-level DEBUG

# Development workflow with Poetry
poetry run slack-mcp-server \
  --transport sse \
  --host 127.0.0.1 \
  --port 3001 \
  --log-level DEBUG

poetry run python -m slack_mcp.mcp \
  --transport stdio \
  --log-level DEBUG

# Modern Python package management
uv run slack-mcp-server \
  --transport sse \
  --host 127.0.0.1 \
  --port 3001 \
  --log-level DEBUG

uv run python -m slack_mcp.mcp \
  --transport stdio \
  --log-level DEBUG

Production Environment

Console Script
Python Module
Poetry
UV

# Recommended for production deployments
slack-mcp-server \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

slack-mcp-server \
  --transport streamable-http \
  --host 0.0.0.0 \
  --port 8080 \
  --log-level WARNING

# Alternative Python module execution
python -m slack_mcp.mcp \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

python -m slack_mcp.mcp \
  --transport streamable-http \
  --host 0.0.0.0 \
  --port 8080 \
  --log-level WARNING

# Development server in production-like mode
poetry run slack-mcp-server \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

poetry run python -m slack_mcp.mcp \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

# Production deployment with UV
uv run slack-mcp-server \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

uv run python -m slack_mcp.mcp \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

Testing Configurations

Console Script
Python Module
Poetry
UV

# Quick testing configurations
slack-mcp-server --log-level DEBUG

slack-mcp-server \
  --transport sse \
  --port 0 \
  --log-level DEBUG

slack-mcp-server \
  --transport sse \
  --mount-path /test/mcp \
  --log-level DEBUG

# Direct execution for testing
python -m slack_mcp.mcp --log-level DEBUG

python -m slack_mcp.mcp \
  --transport sse \
  --port 0 \
  --log-level DEBUG

python -m slack_mcp.mcp \
  --transport sse \
  --mount-path /test/mcp \
  --log-level DEBUG

# Development testing with Poetry
poetry run slack-mcp-server --log-level DEBUG

poetry run slack-mcp-server \
  --transport sse \
  --port 0 \
  --log-level DEBUG

poetry run python -m slack_mcp.mcp --log-level DEBUG

# Modern testing workflow with UV
uv run slack-mcp-server --log-level DEBUG

uv run slack-mcp-server \
  --transport sse \
  --port 0 \
  --log-level DEBUG

uv run python -m slack_mcp.mcp --log-level DEBUG

Container Deployments

Console Script
Python Module
Poetry
UV

# Docker container configuration
slack-mcp-server \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

# Kubernetes pod configuration
slack-mcp-server \
  --transport streamable-http \
  --host 0.0.0.0 \
  --port ${PORT:-3001} \
  --log-level ${LOG_LEVEL:-INFO}

# Docker container configuration
python -m slack_mcp.mcp \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

# Kubernetes pod configuration
python -m slack_mcp.mcp \
  --transport streamable-http \
  --host 0.0.0.0 \
  --port ${PORT:-3001} \
  --log-level ${LOG_LEVEL:-INFO}

# Container deployment with Poetry
poetry run slack-mcp-server \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

poetry run python -m slack_mcp.mcp \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

# Modern container approach with UV
uv run slack-mcp-server \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

uv run python -m slack_mcp.mcp \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO

Environment Variable Override

CLI options can be overridden by environment variables:

CLI Option	Environment Variable	Example
`--transport`	`MCP_TRANSPORT`	`export MCP_TRANSPORT=sse`
`--host`	`MCP_HOST`	`export MCP_HOST=0.0.0.0`
`--port`	`MCP_PORT`	`export MCP_PORT=8080`
`--mount-path`	`MCP_MOUNT_PATH`	`export MCP_MOUNT_PATH=/api`
`--log-level`	`LOG_LEVEL`	`export LOG_LEVEL=DEBUG`
`--timeout`	`MCP_TIMEOUT`	`export MCP_TIMEOUT=60`
`--max-retries`	`MCP_MAX_RETRIES`	`export MCP_MAX_RETRIES=5`

Precedence: CLI arguments override environment variables, which override defaults.

Console Script
Python Module
Poetry
UV

# Environment variable with CLI override
export MCP_TRANSPORT=sse
export MCP_PORT=8080

# This will use stdio transport and port 3001 (CLI overrides)
slack-mcp-server --transport stdio --port 3001

# Environment variable with CLI override
export MCP_TRANSPORT=sse
export MCP_PORT=8080

# This will use stdio transport and port 3001 (CLI overrides)
python -m slack_mcp.mcp --transport stdio --port 3001

# Environment variable with CLI override
export MCP_TRANSPORT=sse
export MCP_PORT=8080

# This will use stdio transport and port 3001 (CLI overrides)
poetry run slack-mcp-server --transport stdio --port 3001

# Environment variable with CLI override
export MCP_TRANSPORT=sse
export MCP_PORT=8080

# This will use stdio transport and port 3001 (CLI overrides)
uv run slack-mcp-server --transport stdio --port 3001

Configuration Scripts

Startup Script Examples

Create reusable startup scripts for different environments:

Development Script (`start-dev.sh`)

Console Script
Python Module
Poetry
UV

#!/bin/bash
# start-dev.sh

export SLACK_BOT_TOKEN="xoxb-your-dev-token"
export MCP_TRANSPORT="stdio"
export LOG_LEVEL="DEBUG"

echo "Starting MCP server in development mode..."
slack-mcp-server \
  --log-level DEBUG \
  --timeout 15 \
  --max-retries 1

#!/bin/bash
# start-dev.sh

export SLACK_BOT_TOKEN="xoxb-your-dev-token"
export MCP_TRANSPORT="stdio"
export LOG_LEVEL="DEBUG"

echo "Starting MCP server in development mode..."
python -m slack_mcp.mcp \
  --log-level DEBUG \
  --timeout 15 \
  --max-retries 1

#!/bin/bash
# start-dev.sh

export SLACK_BOT_TOKEN="xoxb-your-dev-token"
export MCP_TRANSPORT="stdio"
export LOG_LEVEL="DEBUG"

echo "Starting MCP server in development mode..."
poetry run slack-mcp-server \
  --log-level DEBUG \
  --timeout 15 \
  --max-retries 1

#!/bin/bash
# start-dev.sh

export SLACK_BOT_TOKEN="xoxb-your-dev-token"
export MCP_TRANSPORT="stdio"
export LOG_LEVEL="DEBUG"

echo "Starting MCP server in development mode..."
uv run slack-mcp-server \
  --log-level DEBUG \
  --timeout 15 \
  --max-retries 1

Production Script (`start-prod.sh`)

Console Script
Python Module
Poetry
UV

#!/bin/bash
# start-prod.sh

# Load environment variables
source .env.production

echo "Starting MCP server in production mode..."
slack-mcp-server \
  --transport ${MCP_TRANSPORT:-sse} \
  --host ${MCP_HOST:-0.0.0.0} \
  --port ${MCP_PORT:-3001} \
  --log-level ${LOG_LEVEL:-INFO} \
  --timeout ${MCP_TIMEOUT:-60} \
  --max-retries ${MCP_MAX_RETRIES:-5}

#!/bin/bash
# start-prod.sh

# Load environment variables
source .env.production

echo "Starting MCP server in production mode..."
python -m slack_mcp.mcp \
  --transport ${MCP_TRANSPORT:-sse} \
  --host ${MCP_HOST:-0.0.0.0} \
  --port ${MCP_PORT:-3001} \
  --log-level ${LOG_LEVEL:-INFO} \
  --timeout ${MCP_TIMEOUT:-60} \
  --max-retries ${MCP_MAX_RETRIES:-5}

#!/bin/bash
# start-prod.sh

# Load environment variables
source .env.production

echo "Starting MCP server in production mode..."
poetry run slack-mcp-server \
  --transport ${MCP_TRANSPORT:-sse} \
  --host ${MCP_HOST:-0.0.0.0} \
  --port ${MCP_PORT:-3001} \
  --log-level ${LOG_LEVEL:-INFO} \
  --timeout ${MCP_TIMEOUT:-60} \
  --max-retries ${MCP_MAX_RETRIES:-5}

#!/bin/bash
# start-prod.sh

# Load environment variables
source .env.production

echo "Starting MCP server in production mode..."
uv run slack-mcp-server \
  --transport ${MCP_TRANSPORT:-sse} \
  --host ${MCP_HOST:-0.0.0.0} \
  --port ${MCP_PORT:-3001} \
  --log-level ${LOG_LEVEL:-INFO} \
  --timeout ${MCP_TIMEOUT:-60} \
  --max-retries ${MCP_MAX_RETRIES:-5}

Testing Script (`start-test.sh`)

Console Script
Python Module
Poetry
UV

#!/bin/bash
# start-test.sh

export SLACK_BOT_TOKEN="xoxb-test-token"

echo "Starting MCP server in test mode..."
slack-mcp-server \
  --transport sse \
  --port 0 \
  --log-level DEBUG \
  --timeout 10 \
  --max-retries 0

#!/bin/bash
# start-test.sh

export SLACK_BOT_TOKEN="xoxb-test-token"

echo "Starting MCP server in test mode..."
python -m slack_mcp.mcp \
  --transport sse \
  --port 0 \
  --log-level DEBUG \
  --timeout 10 \
  --max-retries 0

#!/bin/bash
# start-test.sh

export SLACK_BOT_TOKEN="xoxb-test-token"

echo "Starting MCP server in test mode..."
poetry run slack-mcp-server \
  --transport sse \
  --port 0 \
  --log-level DEBUG \
  --timeout 10 \
  --max-retries 0

#!/bin/bash
# start-test.sh

export SLACK_BOT_TOKEN="xoxb-test-token"

echo "Starting MCP server in test mode..."
uv run slack-mcp-server \
  --transport sse \
  --port 0 \
  --log-level DEBUG \
  --timeout 10 \
  --max-retries 0

Process Management

Using systemd

Create a systemd service (/etc/systemd/system/mcp-server.service):

Console Script
Python Module
Poetry
UV

[Unit]
Description=Slack MCP Server
After=network.target

[Service]
Type=simple
User=mcp
WorkingDirectory=/opt/slack-mcp-server
EnvironmentFile=/opt/slack-mcp-server/.env.production
ExecStart=/opt/slack-mcp-server/venv/bin/slack-mcp-server \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

[Unit]
Description=Slack MCP Server
After=network.target

[Service]
Type=simple
User=mcp
WorkingDirectory=/opt/slack-mcp-server
EnvironmentFile=/opt/slack-mcp-server/.env.production
ExecStart=/opt/slack-mcp-server/venv/bin/python -m slack_mcp.mcp \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

[Unit]
Description=Slack MCP Server
After=network.target

[Service]
Type=simple
User=mcp
WorkingDirectory=/opt/slack-mcp-server
EnvironmentFile=/opt/slack-mcp-server/.env.production
ExecStart=/opt/slack-mcp-server/.venv/bin/poetry run slack-mcp-server \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

[Unit]
Description=Slack MCP Server
After=network.target

[Service]
Type=simple
User=mcp
WorkingDirectory=/opt/slack-mcp-server
EnvironmentFile=/opt/slack-mcp-server/.env.production
ExecStart=/opt/slack-mcp-server/.venv/bin/uv run slack-mcp-server \
  --transport sse \
  --host 0.0.0.0 \
  --port 3001 \
  --log-level INFO
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Using supervisor

Create supervisor configuration (/etc/supervisor/conf.d/mcp-server.conf):

Console Script
Python Module
Poetry
UV

[program:mcp-server]
command=/opt/slack-mcp-server/venv/bin/slack-mcp-server --transport sse --host 0.0.0.0 --port 3001
directory=/opt/slack-mcp-server
environment=SLACK_BOT_TOKEN="xoxb-token",MCP_TRANSPORT="sse",LOG_LEVEL="INFO"
user=mcp
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/mcp-server.log

[program:mcp-server]
command=/opt/slack-mcp-server/venv/bin/python -m slack_mcp.mcp --transport sse --host 0.0.0.0 --port 3001
directory=/opt/slack-mcp-server
environment=SLACK_BOT_TOKEN="xoxb-token",MCP_TRANSPORT="sse",LOG_LEVEL="INFO"
user=mcp
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/mcp-server.log

[program:mcp-server]
command=/opt/slack-mcp-server/.venv/bin/poetry run slack-mcp-server --transport sse --host 0.0.0.0 --port 3001
directory=/opt/slack-mcp-server
environment=SLACK_BOT_TOKEN="xoxb-token",MCP_TRANSPORT="sse",LOG_LEVEL="INFO"
user=mcp
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/mcp-server.log

[program:mcp-server]
command=/opt/slack-mcp-server/.venv/bin/uv run slack-mcp-server --transport sse --host 0.0.0.0 --port 3001
directory=/opt/slack-mcp-server
environment=SLACK_BOT_TOKEN="xoxb-token",MCP_TRANSPORT="sse",LOG_LEVEL="INFO"
user=mcp
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/mcp-server.log

Help and Version Information

Display Help

Console Script
Python Module
Poetry
UV

# Show all available options
slack-mcp-server --help

# Show version information
slack-mcp-server --version

# Show all available options
python -m slack_mcp.mcp --help

# Show version information
python -m slack_mcp.mcp --version

# Show all available options
poetry run slack-mcp-server --help

# Show version information
poetry run slack-mcp-server --version

# Show all available options
uv run slack-mcp-server --help

# Show version information
uv run slack-mcp-server --version

Built-in Validation

The CLI performs automatic validation:

Console Script
Python Module
Poetry
UV

# Invalid transport (will show error)
slack-mcp-server --transport invalid

# Invalid port range (will show error)  
slack-mcp-server --transport sse --port 70000

# Invalid log level (will show error)
slack-mcp-server --log-level INVALID

# Invalid transport (will show error)
python -m slack_mcp.mcp --transport invalid

# Invalid port range (will show error)  
python -m slack_mcp.mcp --transport sse --port 70000

# Invalid log level (will show error)
python -m slack_mcp.mcp --log-level INVALID

# Invalid transport (will show error)
poetry run slack-mcp-server --transport invalid

# Invalid port range (will show error)  
poetry run slack-mcp-server --transport sse --port 70000

# Invalid log level (will show error)
poetry run slack-mcp-server --log-level INVALID

# Invalid transport (will show error)
uv run slack-mcp-server --transport invalid

# Invalid port range (will show error)  
uv run slack-mcp-server --transport sse --port 70000

# Invalid log level (will show error)
uv run slack-mcp-server --log-level INVALID

Troubleshooting CLI Issues

Common Problems

1. Permission Denied

Console Script
Python Module
Poetry
UV

# Error: Permission denied on port 80
slack-mcp-server --transport sse --port 80

# Solution: Use non-privileged port or run with sudo
slack-mcp-server --transport sse --port 8080

# Error: Permission denied on port 80
python -m slack_mcp.mcp --transport sse --port 80

# Solution: Use non-privileged port or run with sudo
python -m slack_mcp.mcp --transport sse --port 8080

# Error: Permission denied on port 80
poetry run slack-mcp-server --transport sse --port 80

# Solution: Use non-privileged port or run with sudo
poetry run slack-mcp-server --transport sse --port 8080

# Error: Permission denied on port 80
uv run slack-mcp-server --transport sse --port 80

# Solution: Use non-privileged port or run with sudo
uv run slack-mcp-server --transport sse --port 8080

2. Port Already in Use

Console Script
Python Module
Poetry
UV

# Error: Address already in use
slack-mcp-server --transport sse --port 3001

# Solution: Find and kill process or use different port
lsof -ti:3001 | xargs kill -9
# OR
slack-mcp-server --transport sse --port 3002

# Error: Address already in use
python -m slack_mcp.mcp --transport sse --port 3001

# Solution: Find and kill process or use different port
lsof -ti:3001 | xargs kill -9
# OR
python -m slack_mcp.mcp --transport sse --port 3002

# Error: Address already in use
poetry run slack-mcp-server --transport sse --port 3001

# Solution: Find and kill process or use different port
lsof -ti:3001 | xargs kill -9
# OR
poetry run slack-mcp-server --transport sse --port 3002

# Error: Address already in use
uv run slack-mcp-server --transport sse --port 3001

# Solution: Find and kill process or use different port
lsof -ti:3001 | xargs kill -9
# OR
uv run slack-mcp-server --transport sse --port 3002

3. Invalid Configuration

Console Script
Python Module
Poetry
UV

# Error: Invalid transport specified
slack-mcp-server --transport http

# Solution: Use valid transport option
slack-mcp-server --transport sse

# Error: Invalid transport specified
python -m slack_mcp.mcp --transport http

# Solution: Use valid transport option
python -m slack_mcp.mcp --transport sse

# Error: Invalid transport specified
poetry run slack-mcp-server --transport http

# Solution: Use valid transport option
poetry run slack-mcp-server --transport sse

# Error: Invalid transport specified
uv run slack-mcp-server --transport http

# Solution: Use valid transport option
uv run slack-mcp-server --transport sse

Debug Mode

Enable maximum verbosity for troubleshooting:

Console Script
Python Module
Poetry
UV

# Maximum debug output
slack-mcp-server \
  --log-level DEBUG \
  --timeout 5 \
  --max-retries 0

# Maximum debug output
python -m slack_mcp.mcp \
  --log-level DEBUG \
  --timeout 5 \
  --max-retries 0

# Maximum debug output
poetry run slack-mcp-server \
  --log-level DEBUG \
  --timeout 5 \
  --max-retries 0

# Maximum debug output
uv run slack-mcp-server \
  --log-level DEBUG \
  --timeout 5 \
  --max-retries 0

Configuration Verification

Console Script
Python Module
Poetry
UV

# Test configuration without starting server
slack-mcp-server --help > /dev/null 2>&1 && echo '✅ CLI configuration is valid' || echo '❌ CLI configuration error'

# Test configuration without starting server
python -c "
import sys
sys.argv = ['mcp', '--transport', 'sse', '--help']
try:
  from slack_mcp.mcp.cli import main
  print('✅ CLI configuration is valid')
except Exception as e:
  print(f'❌ CLI configuration error: {e}')
"

# Test configuration without starting server
poetry run slack-mcp-server --help > /dev/null 2>&1 && echo '✅ CLI configuration is valid' || echo '❌ CLI configuration error'

# Test configuration without starting server
uv run slack-mcp-server --help > /dev/null 2>&1 && echo '✅ CLI configuration is valid' || echo '❌ CLI configuration error'

For more detailed configuration options, see Environment Configuration. For deployment examples using these CLI options, see Deployment Guide.

Basic Usage​

Command Options​

Transport Options​

--transport​

Network Options​

--host​

--port​

--mount-path​

Logging Options​

--log-level​

Connection Options​

--timeout​

--max-retries​

Usage Examples​

Development Environment​

Production Environment​

Testing Configurations​

Container Deployments​

Environment Variable Override​

Configuration Scripts​

Startup Script Examples​

Development Script (start-dev.sh)​

Production Script (start-prod.sh)​

Testing Script (start-test.sh)​

Process Management​

Using systemd​

Using supervisor​

Help and Version Information​

Display Help​

Built-in Validation​

Troubleshooting CLI Issues​

Common Problems​

1. Permission Denied​

2. Port Already in Use​

3. Invalid Configuration​

Debug Mode​

Configuration Verification​