Skip to main content
Human Intelligence connects to Slack via OAuth 2.0. Once installed, the integration lets us deliver notifications (DMs, channel posts) into your workspace on your behalf.

​
Who Can Install

A Slack workspace admin must install. Granting consent allows a bot called “Human Intelligence” into the workspace.

​
Getting Started

You will need:
  • Slack workspace admin permissions.
  • A Human Intelligence account with access to your organization.

​
Steps

  1. Click Connect, and you will be redirected to slack.com and shown a consent screen listing the bot scopes Human Intelligence is requesting.
  2. Review the scopes (see Permissions below), select the workspace you want to install into, and click Allow.
  3. Slack will redirect you back to Human Intelligence. The Slack tile will switch to Connected within a few seconds.

​
Permissions

Human Intelligence requests a minimal set of bot scopes:
Note: The bot cannot read private channels it has not been invited to, nor DMs it did not initiate.

​
Tokens

  • The bot token Slack issues is stored encrypted at rest in Google Cloud Secret Manager, scoped per customer, behind least-privilege IAM. Human Intelligence developers and support cannot read its value.
  • The token is fetched from Secret Manager only at the moment of an API call, so it is never written to disk, never cached in browsers or logs.
  • All communication with Slack runs over TLS.
  • Every secret access is recorded in Cloud Audit Logs.

​
Verifying Installation

After connecting:
  • The Slack tile in Integrations shows Connected.
  • When a Human Intelligence flow runs (e.g. a scheduled report), its output will arrive as a DM from the Human Intelligence bot.

​
Revoking Access

You can disconnect at any time:
  • From Human Intelligence: Integrations → Slack → Disconnect. We delete our copy of the token immediately.
  • From Slack: any workspace admin can uninstall the Human Intelligence app via Apps & Integrations → Manage. This immediately cuts off Human Intelligence’s access to your Slack workspace.

​
Using Slack with Other Human Intelligence Connectors

Once the Human Intelligence Slack bot is connected to your workspace, any other tool that talks to Human Intelligence (Claude, Notion agents) automatically inherits that Slack connection. You do not need to separately install or authorize Slack inside each of those tools.

​
How it works

The HI MCP exposes Slack as a first-class capability. When an agent in Claude or Notion calls a Slack-shaped action (e.g. “send a message to #launches”), the request is routed through Human Intelligence, which uses the bot token already stored in your workspace to make the call.

​
What you get out of the box

  • Posting messages to channels and DMs from any agent or workflow that uses the HI MCP.
  • Resolving users by name or email so an agent can target the right person without you wiring up IDs.
  • Reading channel and DM history that the HI bot already has access to, surfaced to the agent as context.
  • A single audit trail: every Slack action initiated by any HI-connected tool is attributed to the Human Intelligence bot in Slack, and logged on the HI side.

​
What you need to do on your side

  • Invite the bot to the channels you want it to act in. From any channel: /invite @Human Intelligence.

​
What you do not need

  • You do not need to have your Slack workspace separately connected to Notion, Claude, or any other tool for HI’s Slack features to work there.
  • You do not need to install a Slack MCP alongside the Human Intelligence MCP. Adding both will create duplicate connections and is not recommended.

​
Examples

  • Claude: With the HI MCP installed in Claude, you can ask “post the meeting summary to #product-updates” and Claude will route that through HI’s Slack connection. No Slack connector needs to be enabled in Claude itself.
  • Notion agents: A Notion agent built on the HI MCP can send a DM when a database row changes status, without Notion’s own Slack integration being configured.

​
Troubleshooting

  • “App not approved by admin” — your Slack workspace requires admin approval for new apps. Submit the Human Intelligence app for approval in your Slack admin console, then retry the install.
  • Install completes but the tile stays “Disconnected” — refresh the page; the status poll runs every few seconds. If still disconnected after a minute, disconnect and re-run the install.
  • Notifications not arriving in a channel — make sure the Human Intelligence bot has been added to the channel (/invite @Human Intelligence from inside the channel). The bot can post to any channel without joining only when the channel is public and chat:write.public is granted.

​
Questions

Contact support@humanintelligence.com.