Slack

Read and write Slack with session tokens — no OAuth, no bot, no admin approval.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@aaronsb/slack-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (9)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Slack.

inbox

What needs you: `view='new'` (since your last dismiss), `'unreads'`, `'mentions'

messages

Conversation content: `target=` reads in full, `+around=` context, `+since=` time window, `query=` full Slack search syntax

estate

Workspace shape and relationships: `view='about'\

batch

Run a held plan of reads in one call: `commands=[{tool, params}...]`; playbooks via `save=`/`run=`/`list=`/`delete=

say

Contribute content (Slack-visible): a message, or an emoji reaction

dismiss

Mark inbox items handled — private watermark, invisible to Slack

Documentation Overview

Slack MCP

License Latest Release

MCP server that gives AI agents access to your Slack workspaces using session tokens. No OAuth apps, no bot permissions, no admin approval required.

Beyond reading and writing messages, it accumulates a durable picture of the workspace — every channel and user's state over time, departures kept as dated tombstones — and synthesizes a relationship graph from it on demand: estate view='about' person='X' answers "tell me about X" with their footprint, circle, and a ranked reading plan. The graph is never stored; it is computed per query from two small local ledgers that hold no message content (design note).

How it works

Slack MCP uses your existing browser session tokens (xoxc/xoxd) to interact with Slack on your behalf. It reads stealthily by default — only the mark-read tool triggers read receipts. Everything else is invisible to other users.

Token extraction is built into the binary. If you're logged into Slack in Chrome or Firefox, the setup flow can extract tokens automatically — no copy-pasting from DevTools.

Prerequisites

You need an active Slack session in your browser. Log into your workspace at app.slack.com in Chrome, Chromium, Edge, or Firefox before running setup.

Install

Claude Code

Terminal

claude mcp add slack-mcp -- npx -y @aaronsb/slack-mcp

Then ask Claude to run the auth tool. It will guide you through browser selection, profile selection, and automatic token extraction.

Claude Desktop

Download the .mcpb file for your platform from the latest release:

Platform	File
macOS (Apple Silicon)	`slack-mcp-darwin-arm64.mcpb`
macOS (Intel)	`slack-mcp-darwin-x64.mcpb`
Linux (x64)	`slack-mcp-linux-x64.mcpb`
Linux (ARM)	`slack-mcp-linux-arm64.mcpb`
Windows (x64)	`slack-mcp-windows-x64.mcpb`

Open the file (double-click or drag into Claude Desktop). When prompted for tokens, you can either:

Leave them blank and use the auth tool after connecting
Paste tokens if you already have them

Standalone binary

Download the binary for your platform from releases, then:

bash

# Extract tokens from your browser (interactive)
./slack-mcp setup

# Run as MCP server (stdio, default)
./slack-mcp

# Run as MCP server (SSE, for remote/shared access)
./slack-mcp --transport sse

npm (global)

Terminal

npm install -g @aaronsb/slack-mcp
slack-mcp setup

Token setup

There are three ways to get your Slack tokens, from easiest to most manual:

Automatic (Chrome/Edge)

The auth MCP tool or slack-mcp setup CLI command will:

Detect your installed browsers
Let you pick which browser and profile has Slack
Open the browser, navigate to Slack, and extract tokens via Chrome DevTools Protocol
Validate and save them

Requires Chrome to be fully closed before extraction — your tabs will restore when you reopen it.

Semi-automatic (Firefox)

The setup flow writes a temporary browser extension to a temp directory, then guides you to load it in Firefox via about:debugging. The extension extracts tokens and sends them to the local callback server. It's removed automatically when Firefox closes.

Manual

Run slack-mcp setup or use the auth tool — if no browser is detected or automatic extraction fails, it falls back to a localhost web page with step-by-step DevTools instructions.

You can also set tokens directly via environment variables:

server.ts

export SLACK_MCP_XOXC_TOKEN="xoxc-..."
export SLACK_MCP_XOXD_TOKEN="xoxd-..."
./slack-mcp

Tools

Tool	Kind	What it does
`inbox`	noun	What needs you: `view='new'` (since your last dismiss), `'unreads'`, `'mentions'`
`messages`	noun	Conversation content: `target=` reads in full, `+around=` context, `+since=` time window, `query=` full Slack search syntax
`estate`	noun	Workspace shape and relationships: `view='about'\|'families'\|'person'\|'initiatives'\|'convergence'\|'people'\|'channels'`
`batch`	executor	Run a held plan of reads in one call: `commands=[{tool, params}...]`; playbooks via `save=`/`run=`/`list=`/`delete=`
`say`	verb	Contribute content (Slack-visible): a message, or an emoji reaction
`dismiss`	verb	Mark inbox items handled — private watermark, invisible to Slack
`mark-read`	verb	Fire read receipts — the one visibly-public read signal
`auth`	verb	Interactive token setup (localhost only)
`download`	verb	Download a shared file

Verb encodes effect, noun encodes domain, parameter encodes scope (ADR-009); the batch executor encodes composition, never effect, and admits only the read nouns (ADR-010). Every noun echoes its effective parameters and pages every capped list.

Privacy

Stealth by default — reads never trigger read receipts; only mark-read does
Channel names, not IDs — the AI never sees internal Slack identifiers
Tokens stay local — stored in ~/.config/slack-mcp/config.json with 0600 permissions
Ledgers hold no message content — the durable estate ledger stores entity facts (names, lifecycle, tombstones); the attention ledger stores {user, conversation, day} encounters with a 90-day window; both live under XDG with 0600, and deleting them deletes the graph
Hour-level activity is recorded only for you — colleagues bucket by day, by design
No network traffic except Slack — the binary connects only to slack.com/api/*
No browser downloads — uses your installed browser, never fetches binaries from CDNs

Development

bash

make build          # Build for current platform
make test           # Run tests
make build-all-platforms  # Cross-compile (6 platforms)
make release TAG=v2.1.1   # Tag and push (CI handles the rest)

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Communication View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

23d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Slack

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "slack": { "command": "npx", "args": ["-y","@aaronsb/slack-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/slack?style=directory)](https://allmcps.com/mcp/slack)

HTML Embed

<a href="https://allmcps.com/mcp/slack"><img src="https://allmcps.com/api/badge/slack?style=directory" alt="Slack on AllMCPs" /></a>

Technical Specs & Signals

CategoryCommunication

52Quality signal: Good · 52/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools24/30

Adoption & activity5/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · @aaronsb/slack-mcp (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💬 Communication →Best MCP servers for Slack & Communication →Alternatives to Slack →Install in Claude Desktop Install in Cursor Install in VS Code

Slack

Read and write Slack with session tokens — no OAuth, no bot, no admin approval.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@aaronsb/slack-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (9)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Slack.

inbox

What needs you: `view='new'` (since your last dismiss), `'unreads'`, `'mentions'

messages

Conversation content: `target=` reads in full, `+around=` context, `+since=` time window, `query=` full Slack search syntax

estate

Workspace shape and relationships: `view='about'\

batch

Run a held plan of reads in one call: `commands=[{tool, params}...]`; playbooks via `save=`/`run=`/`list=`/`delete=

say

Contribute content (Slack-visible): a message, or an emoji reaction

dismiss

Mark inbox items handled — private watermark, invisible to Slack

Documentation Overview

Slack MCP

License Latest Release

MCP server that gives AI agents access to your Slack workspaces using session tokens. No OAuth apps, no bot permissions, no admin approval required.

How it works

Token extraction is built into the binary. If you're logged into Slack in Chrome or Firefox, the setup flow can extract tokens automatically — no copy-pasting from DevTools.

Prerequisites

You need an active Slack session in your browser. Log into your workspace at app.slack.com in Chrome, Chromium, Edge, or Firefox before running setup.

Install

Claude Code

Terminal

claude mcp add slack-mcp -- npx -y @aaronsb/slack-mcp

Then ask Claude to run the auth tool. It will guide you through browser selection, profile selection, and automatic token extraction.

Claude Desktop

Download the .mcpb file for your platform from the latest release:

Platform	File
macOS (Apple Silicon)	`slack-mcp-darwin-arm64.mcpb`
macOS (Intel)	`slack-mcp-darwin-x64.mcpb`
Linux (x64)	`slack-mcp-linux-x64.mcpb`
Linux (ARM)	`slack-mcp-linux-arm64.mcpb`
Windows (x64)	`slack-mcp-windows-x64.mcpb`

Open the file (double-click or drag into Claude Desktop). When prompted for tokens, you can either:

Leave them blank and use the auth tool after connecting
Paste tokens if you already have them

Standalone binary

Download the binary for your platform from releases, then:

bash

# Extract tokens from your browser (interactive)
./slack-mcp setup

# Run as MCP server (stdio, default)
./slack-mcp

# Run as MCP server (SSE, for remote/shared access)
./slack-mcp --transport sse

npm (global)

Terminal

npm install -g @aaronsb/slack-mcp
slack-mcp setup

Token setup

There are three ways to get your Slack tokens, from easiest to most manual:

Automatic (Chrome/Edge)

The auth MCP tool or slack-mcp setup CLI command will:

Detect your installed browsers
Let you pick which browser and profile has Slack
Open the browser, navigate to Slack, and extract tokens via Chrome DevTools Protocol
Validate and save them

Requires Chrome to be fully closed before extraction — your tabs will restore when you reopen it.

Semi-automatic (Firefox)

Manual

Run slack-mcp setup or use the auth tool — if no browser is detected or automatic extraction fails, it falls back to a localhost web page with step-by-step DevTools instructions.

You can also set tokens directly via environment variables:

server.ts

export SLACK_MCP_XOXC_TOKEN="xoxc-..."
export SLACK_MCP_XOXD_TOKEN="xoxd-..."
./slack-mcp

Tools

Tool	Kind	What it does
`inbox`	noun	What needs you: `view='new'` (since your last dismiss), `'unreads'`, `'mentions'`
`messages`	noun	Conversation content: `target=` reads in full, `+around=` context, `+since=` time window, `query=` full Slack search syntax
`estate`	noun	Workspace shape and relationships: `view='about'\|'families'\|'person'\|'initiatives'\|'convergence'\|'people'\|'channels'`
`batch`	executor	Run a held plan of reads in one call: `commands=[{tool, params}...]`; playbooks via `save=`/`run=`/`list=`/`delete=`
`say`	verb	Contribute content (Slack-visible): a message, or an emoji reaction
`dismiss`	verb	Mark inbox items handled — private watermark, invisible to Slack
`mark-read`	verb	Fire read receipts — the one visibly-public read signal
`auth`	verb	Interactive token setup (localhost only)
`download`	verb	Download a shared file

Privacy

Stealth by default — reads never trigger read receipts; only mark-read does
Channel names, not IDs — the AI never sees internal Slack identifiers
Tokens stay local — stored in ~/.config/slack-mcp/config.json with 0600 permissions
Ledgers hold no message content — the durable estate ledger stores entity facts (names, lifecycle, tombstones); the attention ledger stores {user, conversation, day} encounters with a 90-day window; both live under XDG with 0600, and deleting them deletes the graph
Hour-level activity is recorded only for you — colleagues bucket by day, by design
No network traffic except Slack — the binary connects only to slack.com/api/*
No browser downloads — uses your installed browser, never fetches binaries from CDNs

Development

bash

make build          # Build for current platform
make test           # Run tests
make build-all-platforms  # Cross-compile (6 platforms)
make release TAG=v2.1.1   # Tag and push (CI handles the rest)

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Communication View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

23d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Slack

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "slack": { "command": "npx", "args": ["-y","@aaronsb/slack-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/slack?style=directory)](https://allmcps.com/mcp/slack)

HTML Embed

<a href="https://allmcps.com/mcp/slack"><img src="https://allmcps.com/api/badge/slack?style=directory" alt="Slack on AllMCPs" /></a>

Technical Specs & Signals

CategoryCommunication

52Quality signal: Good · 52/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools24/30

Adoption & activity5/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · @aaronsb/slack-mcp (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💬 Communication →Best MCP servers for Slack & Communication →Alternatives to Slack →Install in Claude Desktop Install in Cursor Install in VS Code