slackbot

Let people talk to your data through Slack.

User: "What's new this week?"
Bot:  "3 items this week — Q1 roadmap update, Acme's Series B, and the sales pipeline review..."

Clone it, copy the included .env.example, set your keys, run it.

---

• Node.js 20+
• A Slack workspace where you can install apps
• An Anthropic API key

1. Go to api.slack.com/apps → Create New App → From Scratch
2. Name it whatever you want, pick your workspace
3. Go to Socket Mode → toggle it on → generate an app token (starts with xapp-)
4. Go to OAuth & Permissions → add these bot scopes:

• app_mentions:read — see when someone @mentions the bot
• chat:write — post responses
• channels:history — read thread history for context
• im:history — read DM history

1. Install to Workspace → copy the bot token (starts with xoxb-)
2. Go to Event Subscriptions → toggle on → subscribe to:

• app_mention — someone @mentions the bot
• message.im — someone DMs the bot

Notes:

• Default support is DMs + public channels
• If you want private-channel support, add groups:history, reinstall the app, and invite the bot to the private channel
• Any time you change scopes or event subscriptions, reinstall the app to the workspace

1. Go to console.anthropic.com
2. Create an API key
3. Add some credits ($5 is plenty to start)

This repo includes an environment template: .env.example

Required:

• SLACK_BOT_TOKEN
• SLACK_APP_TOKEN
• ANTHROPIC_API_KEY

Optional:

• ANTHROPIC_MODEL — defaults to claude-sonnet-4-20250514
• ANTHROPIC_REQUEST_TIMEOUT_MS — defaults to 15000
• ANTHROPIC_MAX_RETRIES — defaults to 2

Copy the template, then edit it with your values:

git clone https://github.com/Mikeis