# jtalk22/slack-mcp-server [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://github.com/jtalk22/slack-mcp-server  
**GitHub Stars:** 29  
**npm Downloads (last month):** 3321  
**Views:** 6  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/jtalk22-slack-mcp-server

## Description
Your complete Slack context for Claude—DMs, channels, threads, search. No OAuth apps, no admin approval. --setup and done, 11 tools, auto-refresh.

## Tools
Capabilities this server exposes over MCP:

- **slack_token_status** — Check token health, age, auto-refresh status, and cache stats
- **slack_health_check** — Check if Slack tokens are valid and show authentication status
- **slack_refresh_tokens** — Force refresh tokens by extracting from Chrome (requires Slack tab open in Chrome)
- **slack_list_conversations** — List all DMs and channels with user names resolved. Uses cached DMs by default for speed.
- **slack_conversations_history** — Get messages from a channel or DM with user names resolved
- **slack_get_full_conversation** — Export FULL conversation history with all messages, threads, and user names. Can save to file.
- **slack_search_messages** — Search messages across the Slack workspace
- **slack_users_info** — Get detailed information about a Slack user
- **slack_send_message** — Send a message to a channel or DM
- **slack_get_thread** — Get all replies in a message thread
- **slack_list_users** — List all users in the workspace
- **slack_add_reaction** — Add an emoji reaction to a message
- **slack_remove_reaction** — Remove an emoji reaction from a message
- **slack_conversations_mark** — Mark a conversation as read up to a specific message timestamp
- **slack_conversations_unreads** — Get channels and DMs with unread messages, sorted by unread count (highest first)
- **slack_users_search** — Search workspace users by name, display name, or email. Case-insensitive partial match.
- **slack_workflow_save** — Save or update a workflow profile that binds a workflow_kind (support_inbox | incident_room | exec_brief | product_launch_watch | custom) to channels, priority people, retention mode, and summary cadence. Stored locally at ~/.slack-mcp-workflows.json. Hosted brain reads these to return structured JSON per the workflow_kind.
- **slack_workflows** — List all saved workflow profiles from ~/.slack-mcp-workflows.json. Optionally filter by workflow_kind. Returns profile_name, channels, priority_people, retention_mode, summary_cadence, structured_keys, created_at, updated_at.
- **slack_smart_search** — Semantic + lexical hybrid search across your indexed Slack history. Returns ranked results with relevance scores, channel context, thread context, and matched terms. Hosted-only (requires Vectorize + Workers AI). Free tier ships 25 AI tool calls/month (shared across the hosted AI tools); upgrade to Pro $19/mo for unlimited at mcp.revasserlabs.com/pricing.
- **slack_catch_me_up** — Run a structured catch-up against a saved workflow profile. Returns structured JSON per the profile's workflow_kind: support_inbox returns {open_threads, ack_lag, owner_gaps, escalations, next_actions}; incident_room returns {incident_summary, timeline, open_risks, owner_gaps, next_actions}; exec_brief returns {summary, decisions, risks, asks, action_items}; product_launch_watch returns {launch_signals, feedback_themes, blockers, metrics, next_actions}; custom returns {summary, highlights, open_questions, next_actions}. Hosted-only. Free tier ships 25 AI tool calls/month (shared across the hosted AI tools); Pro $19/mo unlocks unlimited.
- **slack_triage** — Classify and route Slack threads against a workflow profile. Returns triage decisions per thread: priority (low|medium|high|urgent), suggested owner, escalation flag, time-sensitivity, and a routing recommendation. Hosted-only. Free tier ships 25 AI tool calls/month (shared across the hosted AI tools); Pro $19/mo unlocks unlimited.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "slack-mcp-server": {
    "command": "npx",
    "args": ["-y","@jtalk22/slack-mcp"]
  }
}
```

## Documentation

## What jtalk22/slack-mcp-server does

jtalk22/slack-mcp-server MCP server gives an MCP client access to Slack conversations and workspace users through a focused local tool surface. It can list channels and DMs, retrieve channel or direct-message history, include thread replies, search messages, resolve user names, inspect unread conversations, and export a complete conversation to a file. The write operations cover sending messages, adding or removing reactions, and marking a conversation as read.

Workflow tools add a local profile layer. Profiles are stored in `~/.slack-mcp-workflows.json` and can associate a workflow type with channels, priority people, retention behavior, and summary cadence. Supported workflow kinds include support inboxes, incident rooms, executive briefs, product launch watches, and custom profiles.

## How it works

The local path runs over stdio and uses the Slack identity already present in Chrome. Setup reads the newest Slack `xoxc-` token from Chrome’s LevelDB, snapshots the cookie database and its WAL files, retrieves Chrome Safe Storage from the macOS Keychain, and decrypts the cookies locally. The material says this process does not transmit the extracted credentials; the server communicates with Slack.

Credential storage can use automatic selection, Keychain-only storage, or files. The server supports token health checks, refresh coordination, atomic writes, profile isolation, and fallback to the last known good in-memory credentials when persistence is temporarily unavailable. `slack_refresh_tokens` extracts refreshed credentials from Chrome and requires a Slack tab to be open there. Request pacing can be controlled with `SLACK_MCP_MIN_REQUEST_INTERVAL_MS` and `SLACK_MCP_MAX_CONCURRENCY`.

## Setup and configuration

Install and run setup with:

```bash
npx -y @jtalk22/slack-mcp --setup
```

The project is intended for Claude Desktop, Cursor, Windsurf, Claude Code, and other stdio MCP clients. The supplied material specifically identifies the local transport as stdio, so the client must be configured to launch the package locally. No Slack app or admin request is required for this local session-based path, but it acts with the permissions of the signed-in Slack identity.

## Tools and capabilities

The jtalk22/slack-mcp-server MCP server includes tools for:

- Checking token health, authentication state, refresh status, and cache statistics.
- Listing conversations, reading histories, retrieving threads, exporting full histories, and finding unread channels or DMs.
- Searching messages and searching workspace users by partial name, display name, or email.
- Inspecting user details and marking conversations read.
- Sending messages and managing reactions.
- Saving and listing workflow profiles.

Three hosted-only tools extend the local features: `slack_smart_search` provides hybrid semantic and lexical search over indexed history; `slack_catch_me_up` produces structured workflow-specific catch-up output; and `slack_triage` classifies and routes threads. These hosted tools require Vectorize and Workers AI. Their free tier includes 25 AI tool calls per month, shared across hosted AI tools; Pro is listed at $19 per month for unlimited use.

## Limitations and notes

Browser-session authentication is not the same as a sanctioned OAuth integration. Enterprise Grid may detect this access pattern and terminate the session; the material recommends hosted OAuth or Slack’s official MCP for Grid deployments. The local server cannot access channels unavailable to the signed-in user or act as another user. Workspace retention, DLP, compliance export, and audit controls still apply.

The hosted workflow features are separate from the local JSON profile primitives and are not available solely from the local tool process. Review the repository code and workspace policies before using a browser-session credential method.

## Getting started with this jtalk22/slack-mcp-server MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/jtalk22-slack-mcp-server/readme_