Slack MCP Server
duolingo/slack-mcp
Acesso ao Slack via MCP com OAuth para ler mensagens e dados de workspace
Ver no GitHubServidor MCP para Slack com autenticação OAuth 2.1, permitindo leitura de mensagens, threads, usuários e canais via Claude e outras ferramentas MCP. Suporta múltiplos usuários com transporte HTTP e pode ser deployado localmente ou em produção.
Instalação
npx convez-ai duolingo/slack-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Recuperar histórico de mensagens de canais Slack
- Buscar e filtrar mensagens em workspace
- Listar usuários e perfis do workspace
- Integrar dados do Slack em agentes Claude
- Automatizar consultas a conversas e threads
Veredito

Ferramenta bem-estruturada para integração Slack com Claude via MCP. Implementação sólida de OAuth 2.1 e read-only access é apropriada para segurança, embora limitada a leitura de dados. Excelente para equipes que querem consultar histórico e contexto do Slack dentro de workflows com IA.
README
A tradução para o português deste README ainda está na fila.
Slack MCP Server
A read-only MCP (Model Context Protocol) server for Slack with OAuth 2.1 authentication.
Demo
https://github.com/user-attachments/assets/211bd428-209f-461a-b9a1-9cc85fd7c438
Available Tools
slack_get_channel_messages- Retrieve messages from channelsslack_get_thread_replies- Get conversation thread repliesslack_search_messages- Advanced message search with filtersslack_get_users- List workspace users or get specific profilesslack_get_channels- List channels or get detailed info
Quick Start
1. Create Slack App
- Visit Slack API Apps and create a new app
- Under App Credentials, copy your
Client IDandClient Secret - Navigate to OAuth & Permissions and add these User Token Scopes:
channels:historygroups:historyim:historympim:historychannels:readgroups:readim:readmpim:readusers:readusers:read.emailsearch:read - Add Redirect URL under OAuth & Permissions:
- For local testing: Use an HTTPS proxy like ngrok (E.g:
https://abc123.ngrok.io/oauth2callback). See local development setup below. - For production:
https://your-domain.com/oauth2callback
- For local testing: Use an HTTPS proxy like ngrok (E.g:
2. Installation
uv sync
3. Local Development Setup (HTTPS Proxy)
Slack requires HTTPS for OAuth callbacks. For local development, use ngrok or a similar HTTPS proxy:
# Visit https://ngrok.com/ to download ngrok and start the proxy
ngrok http 8001
Copy the HTTPS forwarding URL (e.g., https://abc123.ngrok.io/oauth2callback) and add it as a Redirect URL in your Slack app settings.
4. Configuration
Set required environment variables:
export SLACK_CLIENT_ID="your_client_id"
export SLACK_CLIENT_SECRET="your_client_secret"
# Use https://your-domain.com for production.
export SLACK_MCP_BASE_URI="http://localhost"
# Use https://your-domain.com for production.
export SLACK_EXTERNAL_URL="https://abc123.ngrok.io"
# Optional, if you want to run the MCP server on a different port.
export SLACK_MCP_PORT=8001
5. Run the Server
uv run python main.py
The server will start on http://localhost:8001 by default. Make sure your ngrok proxy is running alongside it for OAuth to work.
6. Configure Your MCP Client
Add to your MCP client configuration (e.g. ~/.cursor/mcp.json for Cursor):
{
"mcpServers": {
"slack": { "url": "http://localhost:8001/mcp", "transport": "http" }
}
}
7. Authenticate
Authentication happens automatically via OAuth 2.1 when your MCP client first connects. Your client will open a browser window for Slack authorization — approve access and you're ready to go.
Deployment
For production deployment, you can run it inside docker:
docker build -t slack-mcp .
docker run -p 8001:8001 \
-e SLACK_CLIENT_ID="your_client_id" \
-e SLACK_CLIENT_SECRET="your_client_secret" \
-e SLACK_MCP_BASE_URI="https://your-domain.com" \
-e SLACK_EXTERNAL_URL="https://your-domain.com" \
slack-mcp
Development
Run tests with uv run pytest.
License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Duolingo is hiring! Apply at https://www.duolingo.com/careers