Slack Integration

Capture and manage from Slack

Connect Clear Tangle to your Slack workspace to capture thoughts, view tasks, and get AI planning without leaving your conversations. Supports multiple workspaces and private channels.

Installation

  1. 1Go to Settings → Integrations in Clear Tangle
  2. 2Click "Connect Slack"
  3. 3Authorize Clear Tangle in your Slack workspace
  4. 4You're ready to go!

Multi-Workspace Support

You can connect multiple Slack workspaces to a single Clear Tangle account. Each workspace has separate OAuth credentials.

Slash Commands

CommandUsageDescription
/capture/capture [text]Capture a thought from Slack
/tasks/tasks [overdue|today|week|all]View tasks by urgency
/plan/plan [new|refresh]Get AI priority plan

Examples

/capture Remember to review the Q4 budgetCreates a new capture
/tasks todayShows tasks due today
/plan newGenerates a fresh AI priority plan

Capture Methods

Multiple ways to capture content from Slack:

Direct Messages

DM the Clear Tangle bot with any message to capture it. Just type naturally—no commands needed.

@Mentions

Mention @Clear Tangle in any channel to capture that message or thread.

🧠

Emoji Reactions

React to any message with :brain: or :cleartangle: to capture it.

Image Capture

Attached images are automatically captured with OCR text extraction.

Task Management

View and manage tasks without leaving Slack:

/tasks overdueShows all overdue tasks with due dates
/tasks todayShows tasks due today
/tasks weekShows tasks due this week

Interactive Buttons

Task lists include buttons to mark tasks complete or view them in the full app—no need to type additional commands.

AI Planning

Get AI-powered priority recommendations:

  • /plan - View your last AI-generated plan
  • /plan new - Generate a fresh plan based on current tasks
  • /plan refresh - Force regenerate (clears cache)

The AI considers task priorities, due dates, blockers, and your preferences when generating plans.

Source Tracking

Every Slack capture remembers its origin:

  • Channel name or DM
  • Original author
  • Message timestamp
  • Permalink to original message
  • Workspace ID

Security

Our Slack integration follows security best practices:

  • HMAC-SHA256 request signature verification
  • Timing-safe comparison to prevent timing attacks
  • 5-minute timestamp validation (prevents replay attacks)
  • OAuth 2.0 with signed state parameter (15-min expiration)
  • Row-level security for data isolation

Multi-Workspace Support

Connect multiple Slack workspaces to a single Clear Tangle account:

  1. 1Go to Settings → Integrations
  2. 2Click "Add Another Workspace"
  3. 3Authorize in the new workspace
  4. 4All captures are unified in your account

DM Commands

When messaging the bot directly, use these commands:

CommandDescription
helpShow available commands
tasksView your tasks
planGet AI priority plan
[any text]Captured as a thought

Related Documentation