slack

---

Quick Start

1. Install the plugin — inside Claude Code, run:

/plugin marketplace add JCodesMore/jcodesmore-plugins
/plugin install slack@jcodesmore-plugins

2. Make a Slack bot. Go to https://api.slack.com/apps → Create New App → From scratch → pick a name and your workspace. Open OAuth & Permissions, paste the recommended scope set (below) into Bot Token Scopes, then click Install to Workspace and copy the Bot User OAuth Token (starts with xoxb-).

3. Paste the token into the Slack Bot Token field when Claude Code prompts you, then fully restart Claude Code so the MCP server picks it up.

4. Run the setup wizard — type:

/slack:setup

Claude verifies the token, locks in the active workspace, and tells you what to try next. After that, you can run /slack (no subcommand) any time you want to do something — the main skill routes channel ops, messaging, scheduling, canvases, and workspace-from-brief design from the same entry point.

Try it

Talk to Claude like a sysadmin who actually wants to help:

• "/slack make me a workspace for a 12-person eng team focused on infra." → spawns the architect.
• "/slack apply the small-team template."
• "/slack create a #release-notes channel, set the topic to 'Ship logs only', and invite the @release-eng usergroup."
• "/slack post an announcement in #general with a header block, a section, and a divider."
• "/slack schedule a daily 9am standup ping in #team-standup for next week."
• "/slack make a Project Orion canvas in #proj-orion with the kickoff brief."
• "/slack add a Mods user group with a @mods handle, defaulted to #moderators."

The agent picks the right Slack methods, validates inputs, and reports back what changed (with Slack's actual error codes when something fails).

What it builds

Here's a copy-pasteable workspace-from-brief example. Run this in a fresh test workspace:

/slack make me a workspace for an 8-person ML research lab focused on RLHF

The main skill recognizes the brief, spawns the architect, picks ai-research-lab as a starting point, dry-runs a spec, and shows you a preview before touching anything:

Preview:
  Channels (6):
    paper-club    — Weekly readings, key takeaways, vote on next paper.
    experiments   — Run logs, hyperparam sweeps, hypothesis posts.
    model-eval    — Eval runs, comparisons, failure analyses.
    infra         — Cluster, training stack, dataset pipelines.
    code-review   — PRs, design reviews, refactor proposals.
    general       — Lab-wide announcements + chat.
  Usergroups (2):
    @researchers  — All hands. Defaults to #paper-club, #experiments.
    @lab-leads    — Decision-makers. Defaults to #general.
  Welcome canvas: pinned to #general — onboarding playbook.

Apply this? [Yes / Revise / Cancel]

After you approve, the architect applies it via slack_apply_template and returns a summary plus a rollback log:

Applied to "rlhf-lab" in 4.2s:
  Created 6 channels, 2 usergroups, 1 welcome canvas.
  Skipped 1 (channel "general" already existed).
  Rollback: slack_archive_channel × 5, slack_disable_usergroup × 2, slack_delete_canvas × 1.

If anything goes sideways, hand the rollback log back to Claude — every created resource is paired with the destructive tool that undoes it, so an LLM can walk back the run without guessing IDs.

Features

45+ Slack tools wrapped in two skills and one agent — covering setup, channels, user groups, messaging, Block Kit, scheduling, canvases, users, webhooks, and workspace templates.

Auth & setup

• /slack — main skill. Routes intents (channel ops, messaging, scheduling, canvases, "make me a workspace for…") from a single entry point. Falls back to /slack:setup if the bot token isn't configured yet.
• /slack:setup — friendly conversational walkthrough: verifies your bot token via auth.test, surfaces missing scopes, locks in the active workspace.
• slack_whoami — proves the token works and pins the workspace identity (team_id, team_name, bot_user_id, bot_username) into plugin state.
• SessionStart banner reminds Claude on every new session what workspace is active so it doesn't ask you twice.

Channels (conversations.*)