Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

Interact with Slack from the command line

Project Description

Interact with Slack from the command line.

This was initially a fork of but the two projects have now considerably diverged.


pip install slack-cli

Note that slack-cli is compatible with Python 2.7+ and Python 3.4+.

You should obtain an API token from Slack. This token can passed as an option to the CLI (see below). To obtain a token, go to the [API token generator](

Alternatively, the token can be defined in an environment variable (although it is not recommended [for security reasons](

export SLACK_TOKEN=”slack_token_string”

After the first use, the token will be stored in a local configuration file.


Send message to channel, group or user

Check that everything is working fine:

slack-send -t yourtoken "Hello!" slackbot

Slackbot should answer something nice :) After this first command, the slack token will be saved to a local configuration file and you no longer have to pass the -t argument on the command line. (see slack-pipe -h for more info)

Post to @general from stdin:

date | slack-pipe general

Post to channel:

slack-send "Hello world" general

Send message to user:

date | slack-pipe username

Upload file to channel @random:

slack-upload lolcat.png random

Send non-formatted message to channel:

cat | slack-pipe general

Send the result of a command to John:

slack-run "git status" john

Stream content in real time

The slack-stream command was written to emulate the behaviour of tail -f:

slack-stream general username groupname
Release History

Release History

This version
History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
slack-cli-0.2.1.tar.gz (4.7 kB) Copy SHA256 Checksum SHA256 Source Jun 22, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting