Slack MCP

Servidor MCP que permite a agentes de IA acceder a tus espacios de trabajo de Slack usando tokens de sesión. Sin aplicaciones OAuth, sin permisos de bot, sin necesidad de aprobación de administrador.

Cómo funciona

Slack MCP utiliza tus tokens de sesión existentes del navegador (xoxc/xoxd) para interactuar con Slack en tu nombre. Lee de forma sigilosa por defecto — solo la herramienta mark-read activa los recibos de lectura. Todo lo demás es invisible para otros usuarios.

La extracción de tokens está integrada en el binario. Si has iniciado sesión en Slack en Chrome o Firefox, el flujo de configuración puede extraer los tokens automáticamente — sin necesidad de copiar y pegar desde DevTools.

Related MCP server: slack-mpm

Requisitos previos

Necesitas una sesión activa de Slack en tu navegador. Inicia sesión en tu espacio de trabajo en app.slack.com en Chrome, Chromium, Edge o Firefox antes de ejecutar la configuración.

Instalar

Claude Code

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

Luego pídele a Claude que ejecute la herramienta auth-setup. Te guiará a través de la selección del navegador, la selección del perfil y la extracción automática de tokens.

Claude Desktop

Descarga el archivo .mcpb para tu plataforma desde la última versión:

Abre el archivo (doble clic o arrastra a Claude Desktop). Cuando se te soliciten los tokens, puedes:

• Dejarlos en blanco y usar la herramienta auth-setup después de conectar

• Pegar los tokens si ya los tienes

Binario independiente

Descarga el binario para tu plataforma desde releases, luego:

# 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)

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

Configuración de tokens

Hay tres formas de obtener tus tokens de Slack, de la más fácil a la más manual:

Automática (Chrome/Edge)

La herramienta MCP auth-setup o el comando CLI slack-mcp setup:

1. Detectará tus navegadores instalados

2. Te permitirá elegir qué navegador y perfil tiene Slack

3. Abrirá el navegador, navegará a Slack y extraerá los tokens a través de Chrome DevTools Protocol

4. Los validará y guardará

Requiere que Chrome esté completamente cerrado antes de la extracción — tus pestañas se restaurarán cuando lo vuelvas a abrir.

Semiautomática (Firefox)

El flujo de configuración escribe una extensión de navegador temporal en un directorio temporal, luego te guía para cargarla en Firefox a través de about:debugging. La extensión extrae los tokens y los envía al servidor de callback local. Se elimina automáticamente cuando Firefox se cierra.

Manual

Ejecuta slack-mcp setup o usa la herramienta auth-setup — si no se detecta ningún navegador o la extracción automática falla, recurre a una página web localhost con instrucciones paso a paso de DevTools.

También puedes configurar los tokens directamente a través de variables de entorno:

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

Herramientas

Privacidad

• Sigiloso por defecto — las lecturas nunca activan recibos de lectura; solo lo hace mark-read

• Nombres de canal, no IDs — la IA nunca ve identificadores internos de Slack

• Los tokens permanecen locales — almacenados en ~/.config/slack-mcp/config.json con permisos 0600

• Sin tráfico de red excepto Slack — el binario se conecta solo a slack.com/api/*

• Sin descargas del navegador — utiliza tu navegador instalado, nunca obtiene binarios de CDNs

Desarrollo

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

Licencia

MIT