Public | Automated Build

Last pushed: 2 years ago
Short Description
Bulk delete messages on Slack.
Full Description


Bulk delete messages and files on Slack.


Install from Pip:

pip install slack-cleaner

If you prefer Docker, there is a pre-built Docker image as well:

docker pull kfei/slack-cleaner


# Delete all messages from a channel
slack-cleaner --token <TOKEN> --message --channel general --user "*"

# Delete all messages from a private group
slack-cleaner --token <TOKEN> --message --group hr --user "*"

# Delete all messages from a direct message channel
slack-cleaner --token <TOKEN> --message --direct sherry --user johndoe

# Delete all messages from a multiparty direct message channel. Note that the
# list of usernames must contains yourself
slack-cleaner --token <TOKEN> --message --mpdirect sherry,james,johndoe --user "*" 

# Delete all messages from certain user
slack-cleaner --token <TOKEN> --message --channel gossip --user johndoe

# Delete all messages from bots (especially flooding CI updates)
slack-cleaner --token <TOKEN> --message --channel auto-build --bot

# Delete all messages older than 2015/09/19
slack-cleaner --token <TOKEN> --message --channel general --user "*" --before 20150919

# Delete all files
slack-cleaner --token <TOKEN> --file --user "*"

# Delete all files from certain user
slack-cleaner --token <TOKEN> --file --user johndoe

# Delete all snippets and images
slack-cleaner --token <TOKEN> --file --types snippets,images

# Always have a look at help message
slack-cleaner --help


After the task, a backup file slack-cleaner.<timestamp>.log will be created
in current directory if --log is supplied.

If any API problem occurred, try --rate=<delay-in-seconds> to reduce the API
call rate (which by default is unlimited).

If you see the following warning from urllib3, consider to install missing
packages: pip install --upgrade requests[security] or just upgrade your
Python to 2.7.9.

InsecurePlatformWarning: A true SSLContext object is not available.
          This prevents urllib3 from configuring SSL appropriately and may cause certain SSL connections to fail.
          For more information, see


To all the people who can only afford a free plan. :cry:

Docker Pull Command
Source Repository