Claude Desktop / Claude Code

\n\nAdd to `~/.claude.json` or Claude Desktop settings:\n```json\n{\n \"mcpServers\": {\n \"slack\": { \"command\": \"npx\", \"args\": [\"-y\", \"@jtalk22/slack-mcp\"] }\n }\n}\n```\n

\n\n

Cursor

\n\nAdd to `.cursor/mcp.json`:\n```json\n{\n \"mcpServers\": {\n \"slack\": { \"command\": \"npx\", \"args\": [\"-y\", \"@jtalk22/slack-mcp\"] }\n }\n}\n```\n

\n\n

Windsurf

\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n```json\n{\n \"mcpServers\": {\n \"slack\": { \"command\": \"npx\", \"args\": [\"-y\", \"@jtalk22/slack-mcp\"] }\n }\n}\n```\n

\n\n

Gemini CLI

\n\nAdd to `~/.gemini/settings.json`:\n```json\n{\n \"mcpServers\": {\n \"slack\": { \"command\": \"npx\", \"args\": [\"-y\", \"@jtalk22/slack-mcp\"] }\n }\n}\n```\n

\n\n

Codex CLI

\n\nAdd to `~/.codex/config.toml`:\n```toml\n[mcp_servers.slack]\ncommand = \"npx\"\nargs = [\"-y\", \"@jtalk22/slack-mcp\"]\n```\n\nOr via CLI: `codex mcp add slack -- npx -y @jtalk22/slack-mcp`\n

\n\n## Tools\n\n| Tool | Description | Safety |\n|------|-------------|--------|\n| `slack_health_check` | Verify token validity and workspace info | read-only |\n| `slack_token_status` | Token age, health, and cache stats | read-only |\n| `slack_refresh_tokens` | Auto-extract fresh tokens from Chrome | read-only* |\n| `slack_list_conversations` | List DMs and channels | read-only |\n| `slack_conversations_history` ‡ | Get messages from a channel or DM | read-only |\n| `slack_get_full_conversation` ‡ | Export full history with threads | read-only |\n| `slack_search_messages` ‡ | Search across workspace | read-only |\n| `slack_get_thread` ‡ | Get thread replies | read-only |\n| `slack_users_info` | Get user details | read-only |\n| `slack_list_users` | List workspace users (paginated, 500+) | read-only |\n| `slack_users_search` | Search users by name, display name, or email | read-only |\n| `slack_conversations_unreads` | Get channels/DMs with unread messages | read-only |\n| `slack_send_message` | Send a message to any conversation | **destructive** |\n| `slack_add_reaction` | Add an emoji reaction to a message | **destructive** |\n| `slack_remove_reaction` | Remove an emoji reaction from a message | **destructive** |\n| `slack_conversations_mark` | Mark a conversation as read | **destructive** |\n| `slack_workflow_save` | Save a workflow profile (channels, kind, retention, cadence) to `~/.slack-mcp-workflows.json` | local-write |\n| `slack_workflows` | List saved workflow profiles | read-only |\n| `slack_smart_search` | Semantic search across indexed channels — hosted brain | hosted-stub† |\n| `slack_catch_me_up` | AI-summarized digest of unreads + priority threads — hosted brain | hosted-stub† |\n| `slack_triage` | Prioritized action queue across channels — hosted brain | hosted-stub† |\n\n21 tools total: 12 read-only Slack, 4 write-path Slack, 2 workflow profile primitives (1 local-write, 1 read-only), 3 hosted stubs. All carry [MCP safety annotations](https://modelcontextprotocol.io/specification/2025-03-26/server/tools#annotations).\n\n\\* `slack_refresh_tokens` modifies local token file only.\n\n† Hosted stubs return a structured upgrade payload (`signup_url`, `free_tier_quota`, `pro_value_prop`) — no Slack write occurs from OSS. Activate the brain at [mcp.revasserlabs.com](https://mcp.revasserlabs.com) (free tier, no card).\n\n‡ Also accepts `include_rich_message_fields` to return attachments, blocks, files, reactions, and metadata — see [Rich Message Fields](#rich-message-fields).\n\n## Install\n\n**Node.js 20+**\n\n```bash\nnpx -y @jtalk22/slack-mcp --setup\n```\n\nThe setup wizard handles token extraction and validation.\n\nAfter setup, have your client run `slack_health_check` — a workspace name in the response confirms you are connected.\n\n

Claude Desktop (macOS)

\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"slack\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@jtalk22/slack-mcp\"]\n }\n }\n}\n```\n\n

\n\n

Claude Desktop (Windows/Linux)

\n\nEdit `%APPDATA%\\Claude\\claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"slack\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@jtalk22/slack-mcp\"],\n \"env\": {\n \"SLACK_TOKEN\": \"xoxc-your-token\",\n \"SLACK_COOKIE\": \"xoxd-your-cookie\"\n }\n }\n }\n}\n```\n\n> Windows/Linux users must provide tokens via `env` since auto-refresh is macOS-only.\n\n

\n\n

Claude Code

\n\nAdd to `~/.claude.json`:\n\n```json\n{\n \"mcpServers\": {\n \"slack\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@jtalk22/slack-mcp\"]\n }\n }\n}\n```\n\nOr via CLI: `claude mcp add slack -- npx -y @jtalk22/slack-mcp`\n\n

\n\n

Cursor / Copilot / Other MCP clients

\n\nAny client that supports stdio MCP servers works. Add to your client's MCP config:\n\n```json\n{\n \"slack\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@jtalk22/slack-mcp\"],\n \"env\": {\n \"SLACK_TOKEN\": \"xoxc-your-token\",\n \"SLACK_COOKIE\": \"xoxd-your-cookie\"\n }\n }\n}\n```\n\nOn macOS, tokens are auto-extracted from Chrome — `env` block is optional.\n\n

\n\n

Claude Web / Remote MCP

\n\nHosted tiers at [mcp.revasserlabs.com](https://mcp.revasserlabs.com):\n\n| Tier | Price | What it owns |\n|------|-------|-------------|\n| Self-host | Free (MIT) | Local stdio, all 21 tools (16 read/write Slack + 2 workflow profile primitives + 3 discoverable upgrade stubs to hosted brain) |\n| Hosted Free | $0 (no card) | Email signup, 1 workspace, 10 smart_search/mo + 3 catch_me_up/mo + 5 triage/day. All 5 workflow profile types. 7-day index retention. |\n| Pro | $9/mo | Unlimited AI tools, **scheduled morning catch-up DM** *(rolling out Q2 2026, 8am workspace tz)*, permanent OAuth, 90-day Vectorize, 2 workspaces |\n| Team | $49/mo flat | Pro + shared workflow profiles + audit log + 24h support + scheduled catch-up to channel + 5 workspaces |\n| Ops | from $199/mo (custom) | SLA, custom retention, SOC2 evidence path, multi-tenant isolation, 10+ workspaces, dedicated workflow tuning |\n\n

\n\n

Docker

\n\n```bash\ndocker pull ghcr.io/jtalk22/slack-mcp-server:latest\n```\n\n```json\n{\n \"mcpServers\": {\n \"slack\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\",\n \"-v\", \"~/.slack-mcp-tokens.json:/root/.slack-mcp-tokens.json\",\n \"ghcr.io/jtalk22/slack-mcp-server\"]\n }\n }\n}\n```\n\n

\n\nRestart your client after configuration. Full setup: [docs/SETUP.md](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/SETUP.md)\n\n## How It Works\n\nSession tokens (`xoxc-` + `xoxd-`) from your browser. If you can see it in Slack, this server can see it too.\n\n**Token persistence** — four-layer fallback:\n1. Environment variables (`SLACK_TOKEN`, `SLACK_COOKIE`)\n2. Token file (`~/.slack-mcp-tokens.json`, chmod 600)\n3. macOS Keychain (encrypted)\n4. Chrome auto-extraction (macOS)\n\nTokens expire. The server notices before you do — proactive health monitoring, automatic refresh on macOS, warnings when tokens age out. File writes are atomic (temp file → chmod → rename) to prevent corruption. Concurrent refresh attempts are mutex-locked.\n\n

What's New in 4.2.0

\n\n- **Workflow primitives** — `slack_workflow_save` + `slack_workflows` bind a `workflow_kind` (`incident_room`, `exec_brief`, `support_inbox`, `product_launch_watch`, `custom`) to channels, priority people, retention, and cadence. The hosted brain returns structured JSON per kind — `incident_room` returns `{incident_summary, timeline, open_risks, owner_gaps, next_actions}`, `exec_brief` returns `{summary, decisions, risks, asks, action_items}`. Downstream automation (Linear, Notion, dashboards) consumes the JSON directly.\n- **Discoverable upgrade stubs** — `slack_smart_search`, `slack_catch_me_up`, `slack_triage` appear in OSS as upgrade payloads pointing at the hosted brain. Response shape is `{signup_url, free_tier_quota, pro_value_prop}` — no interruptions, the AI routes the user cleanly.\n- **Six prebuilt templates** — apply with `npx -y @jtalk22/slack-mcp --apply-template --channels C012,C034`. Names: `oncall-handoff`, `support-triage`, `exec-monday`, `sprint-tracker`, `customer-feedback`, `incident-room`. Read them, fork them, edit them — they're JSON profiles.\n- **Setup wizard hosted bridge** — six in-wizard moments surface the hosted free tier (no card) where it matches the user's pain. Stays out of the way otherwise.\n- **Prior reliability fixes carried forward** — LevelDB token extraction, multi-profile enumeration, and explicit SIGTERM/SIGINT/SIGHUP/stdin shutdown handlers ship in 4.2.0 too.\n\nFull release notes on [GitHub releases/latest](https://github.com/jtalk22/slack-mcp-server/releases/latest).\n\n

\n\n## Rich Message Fields\n\nAdded in 4.4.0. The four read tools marked ‡ above accept `include_rich_message_fields: true`, which surfaces the parts of a message that live outside `text` — `attachments`, `blocks`, `files`, `reactions`, `metadata`, plus `subtype`/`bot_id`/`app_id` (automated/bot/app markers) and `team` (workspace id).\n\nAn attachment-only alert reads as empty without the flag:\n\n```json\n{ \"ts\": \"1767368030.607599\", \"user\": \"incident-bot\", \"text\": \"\" }\n```\n\nWith `include_rich_message_fields: true`, the content is surfaced:\n\n```json\n{\n \"ts\": \"1767368030.607599\",\n \"user\": \"incident-bot\",\n \"text\": \"\",\n \"subtype\": \"bot_message\",\n \"bot_id\": \"B012345\",\n \"attachments\": [{ \"title\": \"PagerDuty\", \"text\": \"P1 — API latency > 2s\" }]\n}\n```\n\nOutput shape only — no extra permissions. `blocks` can be large, so it is opt-in per call to keep client context lean. For the full developer payload inside `metadata`, also set `include_all_metadata: true` (an independent Slack flag).\n\n`slack_search_messages` accepts the flag, but Slack's search API does not return rich fields on matches — read full content with `slack_conversations_history` or `slack_get_thread` on the match's channel and timestamp.\n\nPatch by [@rvandam](https://github.com/rvandam) (#143).\n\n## Hosted HTTP Mode\n\nFor remote MCP endpoints (Cloudflare Worker, VPS, etc.):\n\n```bash\nSLACK_TOKEN=xoxc-... \\\nSLACK_COOKIE=xoxd-... \\\nSLACK_MCP_HTTP_AUTH_TOKEN=change-this \\\nSLACK_MCP_HTTP_ALLOWED_ORIGINS=https://claude.ai \\\nnode src/server-http.js\n```\n\nDetails: [docs/DEPLOYMENT-MODES.md](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/DEPLOYMENT-MODES.md)\n\n## Troubleshooting\n\n**Tokens expired:** Run `npx -y @jtalk22/slack-mcp --setup` or use `slack_refresh_tokens` (macOS). To prevent silent expiration during long Claude-idle windows, set up the optional [token-refresh LaunchAgent](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/SETUP.md#keep-tokens-fresh-while-claude-is-closed-macos-optional).\n\n**DMs not showing:** Use `slack_list_conversations` with `discover_dms=true`.\n\n**Client not seeing tools:** Check JSON syntax in config, restart client fully.\n\nMore: [docs/TROUBLESHOOTING.md](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/TROUBLESHOOTING.md)\n\n## Docs\n\n- [Setup Guide](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/SETUP.md)\n- [API Reference](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/API.md)\n- [Roadmap](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/ROADMAP.md)\n- [Architecture](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/ARCHITECTURE.md)\n- [Deployment Modes](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/DEPLOYMENT-MODES.md)\n- [Use Case Recipes](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/USE_CASE_RECIPES.md)\n- [Troubleshooting](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/TROUBLESHOOTING.md)\n- [Compatibility](https://github.com/jtalk22/slack-mcp-server/blob/main/docs/COMPATIBILITY.md)\n\n## Security\n\n- Token files: `chmod 600` (owner-only)\n- macOS Keychain encrypted backup\n- Web server binds to localhost only\n- API keys: `crypto.randomBytes`\n- See [SECURITY.md](https://github.com/jtalk22/slack-mcp-server/blob/main/SECURITY.md)\n\n## Contributing\n\nPRs welcome. Run `node --check` on modified files before submitting.\n\n## License\n\nMIT — See [LICENSE](https://github.com/jtalk22/slack-mcp-server/blob/main/LICENSE)\n\n## Disclaimer\n\nNot affiliated with Slack Technologies, Inc. Uses browser session credentials — check your workspace's acceptable use policy.\n\n---\n\nHosted version live at [mcp.revasserlabs.com](https://mcp.revasserlabs.com): Free tier (no card), $9/mo Pro, $49/mo Team flat, Ops from $199/mo. Hosted owns the AI brain (smart_search, catch_me_up, triage), the scheduled morning catch-up DM at 8am workspace time *(rolling out Q2 2026)*, permanent OAuth (no 2-week token rotation), 90-day Vectorize retention, and shared workflow profiles. The OSS package owns local stdio + the 16 Slack tools (12 read, 4 write) + workflow profile primitives (slack_workflow_save, slack_workflows). The 3 paid stubs (slack_smart_search, slack_catch_me_up, slack_triage) appear in OSS as discoverable upgrade prompts.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Communication","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":104},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[105,106],"license","MIT","language","JavaScript","registryName","io.github.jtalk22/slack-mcp-server","homepage","https://mcp.revasserlabs.com","platform-commercial","status-live","ENV",{"_109":110,"_111":112,"_113":114},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

Slack MCP Server