Slack MCP Server

by mindstoneio.github.mindstone/mcp-server-slackv0.3.0

Slack MCP server: channels, messages, threads, reactions, users, files, and scheduled messages

12Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active10d ago

Install Slack MCP server

claude mcp add slack-mindstone -e SLACK_CONFIG_PATH='<slack-config-path>' -e SLACK_TEAM_ID='<slack-team-id>' -e SLACK_CLIENT_SECRET='<slack-client-secret>' -- npx -y @mindstone/mcp-server-slack

{
  "mcpServers": {
    "slack-mindstone": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-slack"
      ],
      "env": {
        "SLACK_CONFIG_PATH": "<slack-config-path>",
        "SLACK_TEAM_ID": "<slack-team-id>",
        "SLACK_CLIENT_SECRET": "<slack-client-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "slack-mindstone": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-slack"
      ],
      "env": {
        "SLACK_CONFIG_PATH": "<slack-config-path>",
        "SLACK_TEAM_ID": "<slack-team-id>",
        "SLACK_CLIENT_SECRET": "<slack-client-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "slack-mindstone": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-slack"
      ],
      "env": {
        "SLACK_CONFIG_PATH": "<slack-config-path>",
        "SLACK_TEAM_ID": "<slack-team-id>",
        "SLACK_CLIENT_SECRET": "<slack-client-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "slack-mindstone": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-slack"
      ],
      "env": {
        "SLACK_CONFIG_PATH": "<slack-config-path>",
        "SLACK_TEAM_ID": "<slack-team-id>",
        "SLACK_CLIENT_SECRET": "<slack-client-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
SLACK_CONFIG_PATH	yes	—	Path to the host-managed Slack config directory
SLACK_TEAM_ID	yes	—	Slack workspace team ID (one process per workspace)
SLACK_CLIENT_ID	—	—	Slack OAuth Connected App client ID. Only required to refresh a rotating token; saved non-rotating tokens authorize the Slack API without it.
SLACK_CLIENT_SECRET	—	yes	Slack OAuth Connected App client secret. Only required to refresh a rotating token; saved non-rotating tokens authorize the Slack API without it.
SLACK_DISABLE_REFRESH	—	—	Set to 1 to disable token refresh on this surface (cloud surface)
SLACK_REQUEST_TIMEOUT_MS	—	—	Override the upstream timeout (max 300000ms = 5 min)
SLACK_MAX_RETRIES	—	—	WebClient retries on transient failures (0-20). Lower this on cloud to avoid stacking long retry budgets into multi-minute hangs.
MCP_WORKSPACE_PATH	—	—	Workspace directory upload_slack_file reads are constrained to (defaults to the system temp dir when unset)

Freshness

Active — last maintenance signal 10d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-29 · 10d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-06 · 2mo ago · official registry · v0.3.0

FAQ

›How do I install the Slack MCP server in Claude Code?

Run: claude mcp add slack-mindstone -e SLACK_CONFIG_PATH='<slack-config-path>' -e SLACK_TEAM_ID='<slack-team-id>' -e SLACK_CLIENT_SECRET='<slack-client-secret>' -- npx -y @mindstone/mcp-server-slack. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Slack require an API key?

Yes. It expects SLACK_CONFIG_PATH, SLACK_TEAM_ID, SLACK_CLIENT_SECRET, of which 1 is a secret.

›Can I use Slack as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Slack in the official MCP registry?

Yes, as io.github.mindstone/mcp-server-slack.