searching-slack-history

Search Slack message history across channels using Slack Web API endpoints.

1|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/ralphbean/claude-code-plugins --skill searching-slack-history
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: searching-slack-history
Source: https://github.com/ralphbean/claude-code-plugins/tree/main/skills/searching-slack-history
Command: npx skills add https://github.com/ralphbean/claude-code-plugins --skill searching-slack-history

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the frustration of manually sifting through endless Slack messages, allowing you to quickly pinpoint critical information and past conversations. It automates the process of retrieving specific data from your team's communication history, saving you valuable time and reducing the complexity of information retrieval.

Core Features & Use Cases

  • Comprehensive Message Search: Search across all channels the bot has access to, using powerful query operators (e.g., from:@user, in:#channel, after:YYYY-MM-DD).
  • Channel History Retrieval: Fetch recent or time-filtered messages from specific public or private channels.
  • Channel ID Resolution: Easily find a channel's unique ID from its name, streamlining API interactions.
  • Use Case: Imagine you need to compile all discussions about "project X" from the last quarter across multiple channels. This Skill enables you to programmatically query Slack's API, gather all relevant messages, and present them for analysis, eliminating hours of manual searching and context switching.

Quick Start

Using the searching-slack-history skill, find all Slack messages mentioning 'quarterly report' in the '#finance' channel from the last month.

Frequently Asked Questions about searching-slack-history

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Slack message history across multiple channels?

Search Slack message history using the search.messages API endpoint with query operators like `from:@user`, `in:#channel`, and `after:YYYY-MM-DD`. The Skill queries across all channels your bot token has access to, returning matching messages with pagination support via next_cursor.

What permissions and token scopes do I need to search Slack messages?

You need a Slack Bot Token with scopes search:read, channels:history, channels:read, groups:history, and groups:read. These scopes enable the Skill to access message content from public and private channels and execute search queries via the Slack Web API.

Can I retrieve message history from private Slack channels?

Yes. The Skill retrieves messages from both public and private channels using conversations.history and search.messages endpoints. Private channel access requires the bot token to be a member with appropriate group:history and groups:read scopes.

How do I find a Slack channel's ID to use with this Skill?

The Skill resolves channel IDs from channel names through API queries. Once retrieved, the channel ID streamlines subsequent API interactions for fetching specific channel histories and filtering search results.

What's the best way to automate retrieving Slack conversations from the last month?

Use the Skill's time-filtered query operators (e.g., `after:YYYY-MM-DD`) combined with search.messages or conversations.history endpoints. Pagination via next_cursor handles large result sets, enabling programmatic retrieval of all relevant messages across your specified timeframe.

Do I need to make REST API calls manually or does the Skill handle them?

The Skill handles REST API calls to Slack endpoints automatically via WebFetch or curl. You provide search parameters and channel identifiers; the Skill manages authentication, pagination, and response parsing.