Slack agent connector

Slack is a business communication platform that offers messaging, file sharing, and integrations with other tools. This connector provides read access to users, channels, channel members, channel messages, and threads for workspace analytics. It also supports write operations including sending and updating messages, creating and renaming channels, setting channel topics and purposes, and adding reactions to messages.

Example questions

The Slack connector is optimized to handle prompts like these.

• List all users in my Slack workspace
• Show me all public channels
• Who are the members of channel {channel_id}?
• Get messages from channel {channel_id}
• Show me the thread replies for message {ts} in channel {channel_id}
• List all channels I have access to
• Get user details for user {user_id}
• What messages were posted in channel {channel_id} last week?
• Show me the conversation history for channel {channel_id}
• List channel members for the general channel
• Send a message to channel {channel_id} saying 'Hello team!'
• Post a message in the general channel
• Update the message with timestamp {ts} in channel {channel_id}
• Create a new public channel called 'project-updates'
• Create a private channel named 'team-internal'
• Rename channel {channel_id} to 'new-channel-name'
• Set the topic for channel {channel_id} to 'Daily standup notes'
• Update the purpose of channel {channel_id}
• Add a thumbsup reaction to message {ts} in channel {channel_id}
• React with 🚀 to the latest message in channel {channel_id}
• Reply to thread {ts} in channel {channel_id} with 'Thanks for the update!'

Unsupported questions

The Slack connector isn't currently able to handle prompts like these.

• Delete a message from channel {channel_id}
• Remove a reaction from a message
• Archive channel {channel_id}
• Invite user {user_id} to channel {channel_id}
• Remove user {user_id} from channel {channel_id}
• Delete channel {channel_id}
• Create a new user in the workspace
• Update user profile information

Installation

uv pip install airbyte-agent-slack

Usage

Connectors can run in open source or hosted mode.

Open source

In open source mode, you provide API credentials directly to the connector.

from airbyte_agent_slack import SlackConnector
from airbyte_agent_slack.models import SlackTokenAuthenticationAuthConfig

connector = SlackConnector(
    auth_config=SlackTokenAuthenticationAuthConfig(
        api_token="<Your Slack Bot Token (xoxb-) or User Token (xoxp-)>"
    )
)

@agent.tool_plain # assumes you're using Pydantic AI
@SlackConnector.describe
async def slack_execute(entity: str, action: str, params: dict | None = None):
    return await connector.execute(entity, action, params or {})

Hosted

In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead.

This example assumes you've already authenticated your connector with Airbyte. See Authentication to learn more about authenticating. If you need a step-by-step guide, see the hosted execution tutorial.

from airbyte_agent_slack import SlackConnector

connector = SlackConnector(
    external_user_id="<your-scoped-token>",
    airbyte_client_id="<your-client-id>",
    airbyte_client_secret="<your-client-secret>"
)

@agent.tool_plain # assumes you're using Pydantic AI
@SlackConnector.describe
async def slack_execute(entity: str, action: str, params: dict | None = None):
    return await connector.execute(entity, action, params or {})

Replication Configuration

This connector supports replication configuration for MULTI mode sources. See the full reference documentation for details on available options like start_date.

Full documentation

This connector supports the following entities and actions.

Entity	Actions
Users	List, Get
Channels	List, Get, Create, Update
Channel Messages	List
Threads	List
Messages	Create, Update
Channel Topics	Create
Channel Purposes	Create
Reactions	Create

For all authentication options, see the connector's authentication documentation.

For detailed documentation on available actions and parameters, see this connector's full reference documentation.

For the service's official API docs, see the Slack API reference.

Version information

• Package version: 0.1.20
• Connector version: 0.1.7
• Generated with Connector SDK commit SHA: 049f6ad546186bde8303b77e0e1001a831a58654