slack

Slack Integration

Interact with Slack on the user's behalf using the Python Slack SDK - read messages, send replies, download and upload files.

Setup

Ensure the Python Slack SDK is installed:

pip install slack-sdk

Authentication

Use the Slack token from $SLACK_TOKEN environment variable. If not available, ask the user to provide it.

Required scopes (add via https://api.slack.com/apps -> OAuth & Permissions -> User Token Scopes):

• search:read - search messages and files (preferred method)
• users:read - look up users (required for users.list)
• users:read.email - access email addresses in user profiles (optional)
• im:history, im:read - read DMs
• im:write, chat:write - send messages
• channels:history, channels:read - read channels (optional)
• files:read - download files
• files:write - upload files

Python Slack SDK Client

A reusable client module is available at ~/.claude/skills/slack/scripts/slack_client.py.

CLI Usage

# Test authentication
python ~/.claude/skills/slack/scripts/slack_client.py auth

# Search messages
python ~/.claude/skills/slack/scripts/slack_client.py search "from:me to:username" --count 5

# List users
python ~/.claude/skills/slack/scripts/slack_client.py users

# Find a user by name
python ~/.claude/skills/slack/scripts/slack_client.py find-user "Alice"

# List conversations (DMs)
python ~/.claude/skills/slack/scripts/slack_client.py conversations --types im

# Get DM channel with user
python ~/.claude/skills/slack/scripts/slack_client.py dm-channel U12345

# Read messages from channel
python ~/.claude/skills/slack/scripts/slack_client.py read D67890 --limit 10

# Send a message
python ~/.claude/skills/slack/scripts/slack_client.py send D67890 "Hello there!"

Module Usage (inline Python)

import sys
sys.path.insert(0, str(Path.home() / ".claude/skills/slack/scripts"))
from slack_client import (
    test_auth, search_messages, list_users, find_user,
    get_dm_channel, read_messages, send_message,
    get_file_info, download_file, upload_file
)

# Test auth
auth = test_auth()
print(f"Authenticated as {auth['user']}")

# Search messages
messages = search_messages("from:me to:alice", count=5)
for msg in messages:
    print(f"{msg['ts']}: {msg['text']}")

# Find user and send message
user = find_user("Alice")
if user:
    channel = get_dm_channel(user['id'])
    result = send_message(channel, "Hello Alice!")
    print(f"Sent message: {result['ts']}")