mcp-slack-crunchtools
Secure read-only MCP server for Slack workspaces. Provides Claude Code (and other MCP clients) with access to your Slack channels, messages, users, and files without any write permissions.
Features
- Read-only: 15 tools, all read-only. Never posts, edits, or deletes anything.
- Secure: 6-layer security model (input validation, token handling, client hardening, output sanitization, runtime protection, supply chain security).
- User OAuth Token: Uses
xoxp-tokens for user-scoped access to your workspace. - No SDK dependency: Uses
httpxdirectly for minimal, auditable HTTP calls.
Quick Start
Using uvx (Recommended)
claude mcp add mcp-slack-crunchtools \
--env SLACK_USER_TOKEN=xoxp-your-token \
-- uvx mcp-slack-crunchtools
Using Container
claude mcp add mcp-slack-crunchtools \
--env SLACK_USER_TOKEN=xoxp-your-token \
-- podman run -i --rm -e SLACK_USER_TOKEN quay.io/crunchtools/mcp-slack
Local Development
claude mcp add mcp-slack-crunchtools \
--env SLACK_USER_TOKEN=xoxp-your-token \
-- uv run mcp-slack-crunchtools
Setup
See CLAUDE.md for detailed instructions on creating a Slack app and obtaining a User OAuth Token.
Tools
| Tool | Description |
|---|---|
slack_auth_test |
Test connection and get token owner info |
slack_list_channels |
List workspace channels |
slack_get_channel_info |
Get channel details |
slack_get_channel_history |
Read channel messages |
slack_get_thread_replies |
Read thread replies |
slack_list_channel_members |
List channel members |
slack_search_messages |
Search messages |
slack_get_reactions |
Get message reactions |
slack_list_reactions |
List user's reactions |
slack_list_stars |
List starred items |
slack_get_user_info |
Get user details |
slack_list_users |
List workspace members |
slack_get_user_profile |
Get user profile |
slack_list_files |
List files (metadata only) |
slack_get_file_info |
Get file metadata |
Security
See SECURITY.md for the full security design document.
License
AGPL-3.0-or-later
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_slack_crunchtools-0.1.3.tar.gz.
File metadata
- Download URL: mcp_slack_crunchtools-0.1.3.tar.gz
- Upload date:
- Size: 38.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b1066977496e3ff1fef4421cadfecced1e29e371f38e2e7e57bf17f4848886c2
|
|
| MD5 |
45d8ff2f3b1c88387b046781fc0ea138
|
|
| BLAKE2b-256 |
2e40bd2e042083c93f6c8f53fcaeeb538467cfad6993a3f86ee21ac67f1afa6a
|
Provenance
The following attestation bundles were made for mcp_slack_crunchtools-0.1.3.tar.gz:
Publisher:
publish.yml on crunchtools/mcp-slack
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mcp_slack_crunchtools-0.1.3.tar.gz -
Subject digest:
b1066977496e3ff1fef4421cadfecced1e29e371f38e2e7e57bf17f4848886c2 - Sigstore transparency entry: 1182955152
- Sigstore integration time:
-
Permalink:
crunchtools/mcp-slack@65a8a298ca853fdc3290a0aae882f8b25436593f -
Branch / Tag:
refs/tags/v0.1.3 - Owner: https://github.com/crunchtools
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@65a8a298ca853fdc3290a0aae882f8b25436593f -
Trigger Event:
release
-
Statement type:
File details
Details for the file mcp_slack_crunchtools-0.1.3-py3-none-any.whl.
File metadata
- Download URL: mcp_slack_crunchtools-0.1.3-py3-none-any.whl
- Upload date:
- Size: 27.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f4be72b97b31a479405ab6c39d800ef31a38162fd933fdf1831c0299d8f85073
|
|
| MD5 |
9f0924676d94fe11f31dcb3c68ed0a44
|
|
| BLAKE2b-256 |
a11069c0acbf52da9a2962b37f69eb0ece3a09891ea28580d9506b90f8ec0e00
|
Provenance
The following attestation bundles were made for mcp_slack_crunchtools-0.1.3-py3-none-any.whl:
Publisher:
publish.yml on crunchtools/mcp-slack
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mcp_slack_crunchtools-0.1.3-py3-none-any.whl -
Subject digest:
f4be72b97b31a479405ab6c39d800ef31a38162fd933fdf1831c0299d8f85073 - Sigstore transparency entry: 1182955171
- Sigstore integration time:
-
Permalink:
crunchtools/mcp-slack@65a8a298ca853fdc3290a0aae882f8b25436593f -
Branch / Tag:
refs/tags/v0.1.3 - Owner: https://github.com/crunchtools
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@65a8a298ca853fdc3290a0aae882f8b25436593f -
Trigger Event:
release
-
Statement type:
