slack-mpm
Provides tools for Slack workspace integration, enabling management of channels, messages, users, files, reminders, bookmarks, scheduled messages, and more via the Slack API.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@slack-mpmlist all channels"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
slack-mpm
A Python MCP (Model Context Protocol) server and API library for Slack workspace integration. Exposes 40+ Slack operations as MCP tools for use with Claude Desktop, and provides a clean async Python API for building Slack integrations.
What It Is
Python API library:
from slack_mpm.api import messages; await messages.send_message(...)MCP server: wraps the API for Claude Desktop via
slack-mpm mcpAgent scripts: standalone automation scripts in
agents/
Related MCP server: Slack MCP Server
Prerequisites
Python 3.10+ and uv
A Slack App with a bot token
Creating a Slack App
Go to https://api.slack.com/apps and click "Create New App"
Choose "From scratch", give it a name and select your workspace
Go to "OAuth & Permissions" and add these Bot Token Scopes:
channels:read,channels:write,channels:managechat:write,chat:write.publicusers:readfiles:read,files:writereactions:writepins:writebookmarks:read,bookmarks:writeemoji:readgroups:read,groups:writeim:read,im:writempim:read,mpim:write
Install the app to your workspace
Copy the "Bot User OAuth Token" (starts with
xoxb-)
For search_messages and reminders, also create a User Token with search:read, reminders:read, reminders:write.
Quick Start
git clone <repo>
cd slack-mpm
cp .env.local.example .env.local
# Edit .env.local and add your SLACK_BOT_TOKEN=xoxb-...
uv sync
uv run slack-mpm setup # Verify your token works
uv run slack-mpm doctor # Health checkClaude Desktop Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"slack": {
"command": "uv",
"args": ["run", "--directory", "/absolute/path/to/slack-mpm", "slack-mpm", "mcp"]
}
}
}Restart Claude Desktop. You should see the Slack tools available.
Available Tools
Channel Tools (8)
Tool | Description |
| List all channels (public + private) |
| Get details about a channel |
| Create a new channel |
| Archive a channel |
| Invite users to a channel |
| Remove a user from a channel |
| Join a channel |
| Set channel topic |
Message Tools (13)
Tool | Description |
| Send a message (supports blocks + threading) |
| Send a message visible only to one user |
| Edit an existing message |
| Delete a message |
| Get a permanent link to a message |
| Search messages (requires user token) |
| Fetch channel message history |
| Add emoji reaction |
| Remove emoji reaction |
| Pin a message |
| Unpin a message |
| Reply in a thread |
| Fetch all thread replies |
User Tools (5)
Tool | Description |
| List all workspace users |
| Get user details |
| Look up a user by email |
| Open a DM channel with user(s) |
| List channels a user belongs to |
File Tools (5)
Tool | Description |
| Upload a file to channel(s) |
| List workspace files |
| Get file details |
| Delete a file |
| Share an existing file to channels |
Workspace Tools (4)
Tool | Description |
| Get workspace/team info |
| List custom emoji |
| Get bot details |
| Validate token |
Reminder Tools (4)
Tool | Description |
| Create a reminder |
| List reminders |
| Mark reminder complete |
| Delete a reminder |
Bookmark Tools (3)
Tool | Description |
| List channel bookmarks |
| Add a bookmark to a channel |
| Remove a bookmark |
Scheduled Message Tools (3)
Tool | Description |
| Schedule a future message |
| List pending scheduled messages |
| Cancel a scheduled message |
Using the Python API Directly
import asyncio
from slack_mpm.api import messages, channels, users
from slack_mpm.auth.token_manager import TokenManager
async def main():
token = TokenManager().get_token()
# Send a message
await messages.send_message(token, "#general", "Hello from Python!")
# List channels
data = await channels.list_channels(token)
for ch in data["channels"]:
print(ch["name"])
# Get user info
user = await users.get_user_by_email(token, "person@example.com")
print(user["user"]["real_name"])
asyncio.run(main())Agent Scripts
Standalone automation scripts in the agents/ directory.
slack_listener.py — Real-time channel monitor
Polls a channel and prints new messages as they arrive.
uv run agents/slack_listener.py --channel C1234567890
uv run agents/slack_listener.py --channel C1234567890 --interval 10
uv run agents/slack_listener.py --channel C1234567890 --no-historyslack_notifier.py — Send notifications
Sends messages or file uploads to Slack channels from the command line or stdin.
uv run agents/slack_notifier.py --channel C1234567890 --message "Deploy complete"
echo "alert!" | uv run agents/slack_notifier.py --channel C1234567890
cat report.txt | uv run agents/slack_notifier.py --channel C1234567890 --as-file --filename report.txtslack_responder.py — Auto-responder bot
Monitors for @mentions or DMs and auto-replies with a configured message.
uv run agents/slack_responder.py --response "Thanks, I'll get back to you!"
uv run agents/slack_responder.py --channel C1234567890 --response "Got it!" --interval 60
uv run agents/slack_responder.py --response "Out of office" --dry-runslack_digest.py — Activity digest
Generates a summary of recent channel activity: message counts, active users, top threads.
uv run agents/slack_digest.py --channel C1234567890
uv run agents/slack_digest.py --channel C1234567890 --hours 168 # 1 week
uv run agents/slack_digest.py --channel C1234567890 --hours 24 --top-users 10slack_archiver.py — Channel history export
Exports complete channel message history to JSON or Markdown files with thread support.
uv run agents/slack_archiver.py --channel C1234567890 --output ./archive/
uv run agents/slack_archiver.py --channel C1234567890 --output ./archive/ --format markdown
uv run agents/slack_archiver.py --channel C1234567890 --output ./archive/ --days 30Development
# Install dev dependencies
uv sync
# Run tests
uv run pytest
uv run pytest --cov=src --cov-report=html
# Type checking
uv run mypy --strict src/
# Linting
uv run ruff check src/ agents/
uv run ruff format src/ agents/Project Structure
src/slack_mpm/
├── api/
│ ├── _client.py # Shared httpx client + SlackAPIError
│ ├── channels.py # Channel operations
│ ├── messages.py # Message operations
│ ├── users.py # User operations
│ ├── files.py # File operations
│ ├── workspace.py # Workspace operations
│ ├── reminders.py # Reminder operations
│ ├── bookmarks.py # Bookmark operations
│ └── scheduled.py # Scheduled message operations
├── auth/
│ ├── models.py # SlackToken, TokenStatus, WorkspaceInfo
│ └── token_manager.py # TokenManager (loads from .env.local)
├── cli/
│ └── main.py # CLI: setup, doctor, mcp commands
└── server/
└── slack_mpm_server.py # SlackMCPServer (MCP adapter)
agents/
├── slack_listener.py # Channel message poller
├── slack_notifier.py # Send notifications
├── slack_responder.py # Auto-responder bot
├── slack_digest.py # Activity digest
└── slack_archiver.py # History exportThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/bobmatnyc/slack-mpm'
If you have feedback or need assistance with the MCP directory API, please join our Discord server