acip/slack-claude-agent

Analysis updated 2026-05-18

★ 1JavaScriptAudience · developerComplexity · 3/5Setup · moderate

Mindmap

mindmap
  root((slack-claude-agent))
    What it does
      Claude bot in Slack
      Thread conversations
      File change approvals
      Interactive approval cards
    Setup
      Node.js 18+
      Slack app manifest
      Public HTTPS endpoint
      Environment variables
    Tech Stack
      JavaScript
      Claude Agent SDK
      Slack API
      MCP support
    Audience
      Small teams
      Self-hosters
      Developers

mindmap root((slack-claude-agent)) What it does Claude bot in Slack Thread conversations File change approvals Interactive approval cards Setup Node.js 18+ Slack app manifest Public HTTPS endpoint Environment variables Tech Stack JavaScript Claude Agent SDK Slack API MCP support Audience Small teams Self-hosters Developers

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Run an AI coding assistant in your Slack workspace without paying for Anthropic's enterprise plan.

USE CASE 2

Add Claude to a team channel to answer questions and make file edits with a human approval step.

USE CASE 3

Build a custom AI assistant with your own persona file and MCP tool integrations.

USE CASE 4

Automate tasks in a project directory through Slack messages, with explicit plan-and-approve control.

What is it built with?

JavaScriptNode.jsClaude Agent SDKSlack API

How does it compare?

	acip/slack-claude-agent	alexanderdaly/neurofhe-relay	apecollective/gumroad-license-lite
Stars	1	1	1
Language	JavaScript	JavaScript	JavaScript
Setup difficulty	moderate	easy	easy
Complexity	3/5	2/5	1/5
Audience	developer	researcher	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires creating a Slack app, setting two request URLs in the Slack dashboard, and running a public HTTPS endpoint in front of the server.

In plain English

This is a self-hosted Slack bot that puts Claude AI inside your own Slack workspace, intended for personal use or a small team. It runs on a machine you control using the Claude Agent SDK, so you bring your own Anthropic credentials and decide exactly which folder on the host the bot is allowed to read and write. When you mention the bot in a Slack channel or thread, it opens a Claude session for that conversation and streams the reply back as a single live-updating Slack message. Follow-up messages in the same thread continue the conversation automatically without needing to re-mention the bot, and sessions persist across server restarts. Each thread gets its own independent session, so parallel conversations do not mix. The bot includes a built-in approval flow for file changes. Before Claude can modify anything on the host, it must first present a written plan in Slack. You press Approve before any write action happens, or Request Changes to send it back with feedback. When Claude needs a decision from you, it displays radio or checkbox cards directly in Slack rather than a plain text question. You can also prefix any message with "plan:" to explicitly request a plan before any action starts. Setup involves creating a Slack app from the included manifest file, pointing two Slack request URLs at a public HTTPS endpoint that forwards to the server, and filling in a short .env file with your bot token, signing secret, and the path of the directory the agent may access. A custom persona file is optional and stays gitignored so your version stays private. The server runs on Node.js 18 or newer and works with any reverse proxy or tunnel, including Cloudflare, nginx, or ngrok. The README is explicit that this tool gives Claude real shell and filesystem access to the host directory, so it recommends running it in a dedicated virtual machine or container rather than on a machine that holds production credentials or other projects. MCP tool access for integrations like Notion, Google Drive, and GitHub is supported but turned off by default.

Copy-paste prompts

Prompt 1

I'm setting up slack-claude-agent and want to write a custom prompt.md persona for a JavaScript project assistant. What should I include to keep it focused on code review and not touch unrelated folders?

Prompt 2

My slack-claude-agent buttons in Slack do nothing when clicked. Help me figure out why the Interactivity request URL might not be configured correctly.

Prompt 3

Walk me through creating a named, persistent Cloudflare tunnel for slack-claude-agent so the Slack request URL stays stable across restarts.

Prompt 4

I want to add a GitHub MCP server to slack-claude-agent so Claude can read and create GitHub issues from Slack. Show me the configuration steps.

Prompt 5

I'm running slack-claude-agent inside Docker. Help me set PROJECT_WORKSPACE and map the right volumes so the agent only touches the intended directory.

Frequently asked questions

What is slack-claude-agent?

A self-hosted Slack bot that brings Claude AI into your workspace, streams replies into threads, and requires your approval before the AI can modify any files.

What language is slack-claude-agent written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Claude Agent SDK.

How hard is slack-claude-agent to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is slack-claude-agent for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub acip on gitmyhub

Verify against the repo before relying on details.