Overview
The Slack integration allows Alysio to connect directly to a user’s Slack workspace so messages, conversations, files, and collaboration tools can be accessed and managed through natural language. Once connected, Alysio can interact with Slack channels, direct messages, and collaborative documents. Users can send or schedule messages, search conversations, read threads, retrieve user profiles, and create or view Canvas documents without leaving Alysio. Common examples include Posting updates to a Slack channelSending a direct message to a teammate
Scheduling reminders for later
Searching conversations across the workspace
Reading a thread or reviewing a discussion
Creating a Canvas document for meeting notes or project documentation All actions occur through the authenticated Slack account connected by the user and respect the permissions defined within the Slack workspace.
Supported Data and Capabilities
Messaging
Alysio can send, schedule, or draft Slack messages. Supported actions include Posting messages to channelsSending direct messages to users
Scheduling messages for a future time
Creating draft messages for later review or sending This allows users to coordinate updates, reminders, and notifications directly through Alysio.
Search and Discovery
Alysio can search Slack conversations and files across the workspace. Supported actions include Searching messages and files in public channelsSearching across public channels, private channels, direct messages, and group conversations
Finding channels by name or description
Finding users by name, email, or profile attributes These capabilities allow users to quickly retrieve historical conversations and project discussions.
Reading and Viewing Content
Alysio can retrieve and display Slack content such as channel messages or thread conversations. Supported actions include Reading recent channel message historyViewing all messages within a thread
Viewing Slack Canvas documents
Retrieving detailed Slack user profiles
Canvas Documents
Slack Canvas documents can be created and viewed through Alysio. Supported actions include Creating new Canvas documentsViewing Canvas content within Slack Canvas documents are often used for meeting notes, project briefs, and team documentation.
Authentication
Method
OAuth 2.0 with SlackAPI Provider
Slack Web API and Slack Canvas APIsRedirect URI
Configured during Slack integration setup in Alysio.The Slack application must include this URI in its OAuth configuration.
Token Handling
OAuth tokens are securely stored and automatically refreshed. Each user connects their own Slack account, ensuring that API calls operate within the context of the correct workspace and user identity. If a user disconnects Slack or revokes access, Slack tools will stop working until the integration is reauthorized.Required OAuth Scopes
The Slack integration requires both bot token scopes and user token scopes to support messaging, search, and workspace discovery.Bot Token Scopes
team:readchat:write.public
users:read
im:write
chat:write
channels:read
app_mentions:read
commands
assistant:write
im:history
groups:read
users:read.email
User Token Scopes
search:read.publicsearch:read.private
search:read.mpim
search:read.im
search:read.files
search:read.users
chat:write
channels:history
groups:history
mpim:history
im:history
canvases:read
canvases:write
users:read
users:read.email
team:read Some features require additional permissions depending on workspace configuration. Private channel access requires groups:read and groups:history scopes.
Canvas features require Slack workspaces that support Canvas.
MCP Tools
The Slack MCP provides tools that allow Alysio to interact with Slack conversations, users, and documents using natural language.Messaging Tools
slack_send_message
Sends a message to a Slack channel or direct message conversation. Example prompts Post this update to #generalSend a DM to John with the meeting summary
slack_schedule_message
Schedules a Slack message to be sent at a future time. Example prompts Schedule a reminder tomorrow at 9amPost this update Friday at noon
slack_send_message_draft
Creates a draft Slack message that can be reviewed or sent later. Example prompts Draft a message to #salesCreate a draft for the weekly team update
Search and Discovery Tools
slack_search_public
Searches Slack messages and files within public channels. Example prompts Search public channels for launch timelineFind messages about the roadmap
slack_search_public_and_private
Searches messages across the entire workspace including private channels and direct messages. Example prompts Search all Slack messages for client feedbackFind any conversation mentioning the budget
slack_search_channels
Finds Slack channels by name or description. Example prompts Find channels related to engineeringList channels with support in the name
slack_search_users
Finds Slack users by name, email, or profile information. Example prompts Find user john@company.comSearch for users named Sarah
Reading and Viewing Tools
slack_read_channel
Retrieves recent message history from a Slack channel. Example prompts Show the last messages in #generalRead channel history for #engineering
slack_read_thread
Retrieves the full conversation from a Slack thread. Example prompts Show all replies in this threadRead the full discussion
slack_read_canvas
Displays the content of a Slack Canvas document. Example prompts Show the Canvas document for the product briefRead the Canvas content
slack_read_user_profile
Retrieves detailed Slack user profile information. Example prompts Show John’s Slack profileGet profile information for Jane
Canvas Tools
slack_create_canvas
Creates a new Slack Canvas document with formatted content. Example prompts Create a Canvas with meeting notesCreate a Canvas for the Q1 planning session
App Behavior
Slack API calls are executed only when a user asks Alysio to perform an action or retrieve information. There is no background synchronization. Each request triggers the appropriate Slack API endpoint using the authenticated user’s OAuth credential. When needed, Alysio may first retrieve channel or user identifiers using search tools before performing messaging or reading operations.Example Workflow
User asks Search Slack for Q4 roadmap discussions and post a summary to #product. Alysio routes the request to the Slack MCP. The MCP searches Slack conversations using the workspace search tool. The MCP identifies the #product channel using the channel search tool. A summary of the results is generated. The MCP posts the summary to the channel using the send message tool. Slack confirms the message delivery and Alysio returns the result to the user.Troubleshooting
Missing or Expired Connection
Slack has not been authorized or the connection has expired. SolutionReconnect Slack under Settings → Integrations and complete the OAuth authorization flow.
401 Unauthorized
The Slack OAuth token is invalid or expired. SolutionReauthorize the Slack integration to generate a new token.
403 Forbidden or Missing Scope
The Slack application does not have the required OAuth permissions. SolutionUpdate the Slack app configuration to include the required scopes and reinstall or reauthorize the integration.
Channel or User Not Found
Slack messaging and reading tools require valid identifiers. SolutionUse the search tools to retrieve the correct channel or user ID before sending or reading messages.
Limited Search Results
Private channel or direct message searches require additional scopes and channel access. SolutionEnsure the Slack application has the appropriate scopes and has been added to the channel.
Canvas Features Not Available
Canvas functionality may not be enabled in the workspace. SolutionConfirm that the Slack workspace supports Canvas and that the integration has the required Canvas scopes.