iri docs

Slack integration

Run /iri-* commands in Slack to summarize channels, ask your iri workspace questions, search notes, or capture quick decisions. Each command writes (or reads) against the iri workspace tied to the Slack workspace you installed iri into.

What you get

Command What it does Counts toward quota?
/iri-summary [hours] Summarize the recent thread of this channel into an iri note. Default 24h. Accepts 6h, 1d, 30m, etc. Yes (one summary call)
/iri-ask <question> RAG-style answer using your workspace notes, with sources Yes (one ask call)
/iri-find <query> Top 5 matching notes with excerpts No
/iri-capture <text> Save a quick note to the default (or routed) sphere No
/iri-recent List 5 most-recent notes across the workspace No
/iri-help Show all commands No

summary and ask count against your monthly server-LLM quota (Free 10/mo, Pro EA 100/mo). Read commands and capture are free, rate-limited.

Setup

You need workspace admin or manager permissions in iri.

1. Install iri to your Slack workspace

  1. From iri: Workspace → Integrations → Slack → Install to Slack.
  2. Slack approval screen → click Allow.
  3. You're redirected back to iri with the integration connected.

2. Pick a default destination

Where /iri-summary and /iri-capture write notes when no per-channel route applies.

  • Target sphere. The sphere those notes go into (e.g. dev, operations).
  • Folder. Optional sub-folder name (e.g. standups, decisions).

3. Invite the bot to a channel

In Slack, in any channel you want iri to summarize:

/invite @iri

The bot needs to be a member of the channel to read its history. Without this, /iri-summary returns "iri isn't a member of this channel".

4. Try it

/iri-summary 6h

The bot acks immediately with "Working on the summary…", then 5–10 seconds later posts the link to a new iri note containing the summary.

Per-channel routing

By default every /iri-summary and /iri-capture goes to the default sphere/folder. You can route specific channels somewhere else:

  • In iri: Integrations → Slack → "Send specific channels to specific spheres" → pick channel + sphere + folder → Add rule.
  • In Slack inline: /iri-summary save-to=engineering/standups runs the summary AND remembers that route for this channel from now on.
  • One-time override: /iri-summary 6h to=strategy/decisions uses that destination just this once, doesn't persist.

Priority: inline to= > channel route > default.

Two modes (auto vs agent)

The Slack integration supports two usage patterns. Pick from the workspace settings, or just use whichever feels right.

Auto mode (default). iri does the summarization on the server with its own LLM call. Counts toward your quota. Simple: type /iri-summary, get a note back.

Agent mode. Your AI agent (Claude Code, Cursor) reads the Slack messages via the iri MCP server (list_slack_messages, read_slack_messages) and writes the note itself with create_note. Doesn't count toward iri's server-LLM quota; uses your own agent's tokens. More flexible (custom prompts, custom format), more setup.

Limits per plan

Free Pro EA
Monthly server-LLM calls (summary + ask) 10 100
Per-summary message cap 500 2,000
Daily auto-summary cron not available 3 channels

Hitting the Free monthly cap → contact hello@iri-ai.com for higher pilot limits.

Troubleshooting

Bot doesn't respond to slash commands.

  • Make sure the iri Slack app is installed (workspace settings).
  • Check that the bot is invited to the channel: /invite @iri.
  • Reinstall the app (Integrations → Slack → Disconnect → Install) if it stops responding entirely.

/iri-summary says "iri can't read this channel".

  • The bot isn't a member of the channel. /invite @iri.
  • Or the bot is in but the channel was just renamed; reinstall.

Slash command isn't in autocomplete.

  • The Slack app config might be stale. From your Slack admin, reinstall the app from api.slack.com/apps.

Summary lists raw U0XXXX user IDs.

  • The Slack app is missing the users:read scope. Reinstall from the manifest.

Quota exceeded message.

  • Free tier is 10/mo. Either wait for the monthly reset, switch heavy users to Agent mode (no quota), or contact us.

Privacy

  • iri stores Slack messages temporarily during summarization, then writes only the summary to your workspace.
  • Per-message metadata (channel ID, author user ID, timestamp) is logged for audit.
  • The bot's OAuth token is encrypted at rest with AES-256-GCM.
  • Disconnect at any time from Integrations → Slack → Disconnect; we revoke the token and drop the integration row.