# Put your AI agent in Slack

Source: https://catalex.co/slack-ai-agent/ · Updated 2026-11-19

CatalEx connects your Claude Code or Codex agent to Slack through a Slack app you create in your own workspace. People mention the app in a channel or send it a direct message, and the agent replies in Slack, with the tools, files and instructions it already has.

## How a Slack agent works with CatalEx

You create a Slack app from a link CatalEx gives you and install it in your workspace. Mention the app in a channel, or message it directly, and CatalEx passes the message to your agent on your Mac. The reply comes back in the same thread. CatalEx never asks for a Slack configuration token, and you run no server or tunnel.

- **Threads.** Each conversation stays in its thread, so the agent keeps the context.

- **Files.** People can share files with the agent, and the agent can send files back.

- **Approvals.** When the agent wants to do something that needs a person's say, it asks in Slack.

## Your agent keeps its tools: Jira, GitHub, Linear and more

CatalEx does not replace your agent's tools. If your Claude Code or Codex agent already has a Jira, GitHub, Linear or Notion tool through an MCP server, it keeps it. In CatalEx you choose, per agent, which of those tools it may use and which actions need approval.

That is how a Slack request like "file a bug for the checkout error and assign it to Ravi" turns into a Jira ticket: Slack is the channel, the Jira tool does the work, and you decide whether it needs a yes first.

## What teams use a Slack agent for

- **The team's AI brain.** Answers about the codebase, runbooks and docs, without queuing for an engineer.

- **Incidents and deploys.** Summarise an alert, propose a rollback and wait for approval.

- **Tickets.** Create and update Jira or Linear issues from a conversation.

- **Reports.** Post a chart or file when someone asks for it.

## How to add your agent to Slack

1. **Install CatalEx**: Download [CatalEx for Mac](https://downloads.catalex.co/latest/CatalEx-arm64.dmg) and sign in with Google.
2. **Add your agent**: Point CatalEx at your agent's folder and check it answers. [Add an agent](https://docs.catalex.co/agents/add-an-agent).
3. **Create the Slack app**: Open **Add channel**, choose **Slack**, and follow the link CatalEx gives you to create and install the app. You need permission to install apps, or an admin to approve it. [Connect Slack](https://docs.catalex.co/channels/slack).
4. **Mention it**: Mention the app in a channel or send it a direct message, and check it replies.

## Frequently asked questions

### How do I add an AI agent to Slack?

Install CatalEx on your Mac, add your Claude Code or Codex agent, then add a Slack channel. CatalEx gives you a link to create the Slack app in your workspace; once installed, mention it or DM it.

### Do I need to host a Slack bot server?

No. Slack runs through CatalEx Cloud, so you need no server, tunnel or public address. Your Mac must be awake and online for the agent to answer.

### Can my Slack agent create Jira tickets?

Yes, if the agent has a Jira tool, for example through an MCP server in Claude Code or Codex. CatalEx lets you allow or block that tool per agent and require approval before it acts.

### Can I run several agents in one Slack workspace?

Yes. Each Slack app belongs to one agent at a time, so create one app per agent.

### Does the agent see every message in my workspace?

It sees messages that mention its app and direct messages to it, in the conversations where it is used.

## Get CatalEx

- Download for Mac (Apple silicon): https://downloads.catalex.co/latest/CatalEx-arm64.dmg
- Docs: https://docs.catalex.co/
