Slackcli

slackcli

A command-line interface for Slack, designed for both humans and AI agents.

Not the Official Slack CLI

This project is **not** affiliated with Slack or Salesforce. If you're looking to build Slack apps with workflows, triggers, and datastores, check out the [official Slack CLI](https://api.slack.com/automation/cli).

**What's the difference?**

Feature	slackcli (this project)	Official Slack CLI
Purpose	Direct API access for automation & scripting	Build and deploy Slack apps
Use cases	Read messages, search channels, AI agent integration	Workflows, triggers, datastores, app development
Authentication	Bot/User OAuth tokens	Slack app credentials
Complexity	Simple Python CLI	Full development framework

**When to use slackcli:**

• Reading and searching Slack messages
• Sending, editing, and deleting messages
• Sending direct messages to users
• Uploading files to channels
• Adding and removing reactions
• Pinning and unpinning messages
• Scheduling messages for later delivery
• Managing and searching users
• Automating channel exploration
• Integrating Slack into AI agents and scripts
• Quick API interactions from the terminal

Installation

First clone the repository, then:

# Install globally with uv (editable mode)
uv tool install -e .

Editable mode means updates are automatic after `git pull` - no reinstall needed.

Configuration

Create a configuration file at `~/.config/slackcli/config.toml`:

# Default organization (optional)
default_org = "myworkspace"

[orgs.myworkspace]
token = "xoxp-your-user-token-here"

[orgs.another-workspace]
token = "xoxp-another-token"

Workspaces

On Slack Enterprise Grid one token serves the grid org and the workspaces inside it, and each of them has its own host name. Add the extra names under `workspaces` so a single entry answers to all of them:

[orgs.acme]
toke