---
id: slackclient
version: "2.9.4"
license: MIT
license_treatment: permissive
maintenance: active
---

# slackclient — Slack API clients for Web API and RTM API (Legacy) - Please use https://pypi.org/project/slack-sdk/ instead.

License: permissive · Maintenance: active · Downloads: 7.7M/mo

## What it is and what it does

slackclient is a Python SDK for interacting with Slack's Web API and RTM API, enabling developers to build custom applications, bots, and integrations that send messages, upload files, and respond to real-time events in Slack. It wraps Slack's HTTP and WebSocket APIs with Python methods, handling authentication via tokens and providing event-driven callbacks for RTM connections.

The package requires Python 3.6 and above and depends on aiohttp for async HTTP operations. It is currently in maintenance mode; the project's own documentation recommends migrating to the successor project for new development, which offers additional features like Socket Mode, OAuth flows, and improved asyncio support. Existing slackclient code can continue to function, but users should plan for eventual migration.

Use it for:

- Send messages and notifications to Slack channels programmatically from Python applications.
- Upload files to Slack channels as part of automated workflows or reporting systems.
- Build event-driven bots that listen for and respond to messages using the RTM API.
- Integrate third-party services into Slack by posting updates or alerts to specific channels.
- Create custom Slack apps that interact with the Web API for channel management and user interactions.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python interfaces to Slack's Web API and Real Time Messaging (RTM) API for building Slack applications and bots.

Yes, but with conditions: slackclient remains functional and suitable for maintaining existing applications, but the project's own documentation explicitly recommends the successor project for new development. Install only if you are maintaining legacy code or have a specific reason not to migrate. For new Slack integrations, use the successor project instead.

## Install

pip install slackclient
uv add slackclient
poetry add slackclient

## Installing slackclient

Before you install: Low install friction with a single runtime dependency (aiohttp). Active maintenance status with recent commits, though the package is in maintenance mode.

License in practice: MIT license permits commercial and private use with minimal restrictions, making it suitable for most projects.

Quickstart:

pip install slackclient

from slackclient import WebClient
import os

client = WebClient(token=os.environ['SLACK_API_TOKEN'])
response = client.chat_postMessage(channel='#random', text='Hello world!')

Requires a valid Slack API token set in the SLACK_API_TOKEN environment variable and appropriate bot permissions.

Verify before relying:

- Whether async/await patterns are fully supported across all API methods or only specific ones.
- Current state of RTM API support given Slack's deprecation timeline for real-time messaging.
- Performance characteristics when handling high-volume message throughput or large workspaces.
- Specific migration path and effort required to move from slackclient to the successor project.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 7.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

slack api client python, slack web api wrapper, slack rtm real time messaging, slack bot library, slack chatbot sdk, slack message posting, slack websocket client, slack-integration, chat-api, legacy-maintained

[View on SkillFed](https://skillfed.io/packages/slackclient) · [View on PyPI](https://pypi.org/project/slackclient/)