Claude + Slack Work Surface: Setup Package
Four setup guides for Slack, Gmail and GitHub, the two GitHub Actions workflow files that run them, a prerequisite checker, and troubleshooting, assembled in the order you run them.
You finish with one read-only question asked in Slack, answered in a GitHub issue thread, with your laptop closed.
What's inside
prerequisites.sh — the gate you run first
Six checks in about two seconds: the GitHub CLI, whether you are authenticated, whether your token carries the workflow scope, whether you are admin on the repository, your Claude Code version, and jq. Each FAIL line prints the exact command that fixes it. The workflow scope is the one people lose an hour to.
Guide 1 — Run Claude from Slack
The main build. Install the Claude GitHub app, add the workflow to your repository, authenticate, and connect Slack. Ends with porting steps so the second repository takes a fraction of the time.
Two-turn acceptance test
How to prove the loop actually works. Ask one read-only question, then challenge the answer and watch whether it rechecks. Two turns, because one turn only proves it replied.
claude.yml — the interactive loop
The workflow file that answers @claude in an issue thread. The comment block naming why the tool allowlist is inert in tag mode is left in on purpose.
Guide 2 — Gmail MCP in GitHub Actions
Where a job gets real credentials. Run it only after the acceptance test passes, because a credential problem and a connection that never worked look identical.
gmail-smoke-test.yml — the scheduled job
A scheduled workflow that proves the credentials still work without you watching. Ships beside guide 2.
Guides 3 and 4 — GitHub and Slack MCP
Reference for the two connections. Read them when a connection misbehaves rather than front to back.
README with the run order and honest limits
The assembly map: what each file is, the order to run them, what GitHub Actions minutes cost, and the plain statement that the allowlist line in claude.yml is not a security boundary.
Included with your membership.
Enter your membership email and we'll send a private download link that works for one year.