slackdump
rusq · rusq/slackdump
An MCP server that allows AI agents to archive and export private and public Slack messages, channels, files, and users locally.
Save or export your private and public Slack messages, threads, files, and users locally without admin privileges.
Preview
What you can do with it
- Create a local backup of important Slack conversations.
- Export specific Slack channel discussions for analysis or documentation.
- Migrate Slack messages to another platform like Mattermost.
Safety check
No risky patterns found in the files we scanned.
Automated scan of the repo files. Always review code you run.
From the README
Slack Dumper
Purpose: archive your private and public Slack messages, users, channels, files and emojis. Generate Slack Export without admin privileges.
Quick links:
-
Buy me a cup of tea, or use GitHub Sponsors button on the top of the page.
-
How to's:
[!WARNING]
Enterprise Workspaces Security Alerts
Depending on your Slack plan and security settings, using Slackdump may trigger Slack security alerts and/or notify workspace administrators of unusual or automated access/scraping attempts.
You are responsible for ensuring your use complies with your organisation’s policies and Slack’s terms of service.
Description
Typical use scenarios:
- archive your private conversations from Slack when the administrator does not allow you to install applications OR you don't want to use potentially privacy-violating third-party tools;
- archive channels from Slack when you're on a free "no archive" subscription; so you don't lose valuable knowledge in those channels;
- create a Slack Export archive without admin access;
- create incremental Slack archives, which is particularly useful for free workspaces with 90-day limits;
- save your favourite emojis; AND
- analyse you Slack data with AI Agent using Slackdump MCP Server.
There are several modes of operation
- List users/channels
- Dumping messages and threads
- Creating a Slack Export in Mattermost or Standard modes.
- Creating an Archive (Sqlite database or stored as json+gz)
- Converting an archive to other formats (Export, Dump).
- Emoji download mode.
- Viewing Slack export, dump or archive files or directories (displays images).
- Search mode (messages and files).
- Resuming previous archive (adding new messages to an existing archive).
- Local MCP Server to use with Opencode, Claude, or any other AI tool supporting mcp over STDIO or HTTP.
- Database tools: merge multiple archives, remove duplicates, and clean up
unfinished sessions (
slackdump tools merge/dedupe/cleanup).
Run slackdump help to see all available options.
Installation and Quickstart
On macOS, you can install Slackdump with Homebrew:
brew install slackdump
On other Operating Systems, please follow these steps:
- Download the latest release for your operating system from the releases page.
- Unpack the archive to any directory.
- Run the
./slackdumporslackdump.exeexecutable (see note below). - You know the drill: use arrow keys to select the menu item, and Enter (or Return) to confirm.
- Follow these quickstart instructions.
[!NOTE] On Windows and macOS you may be presented with "Unknown developer" window, this is fine. Reason for this is that the executable hasn't been signed by the developer certificate.
To work around this:
- on Windows: click "more information", and press "Run Anyway" button.
- on macOS 14 Sonoma and prior: open the folder in Finder, hold Option and double click the executable, choose Run.
- on macOS 15 Sequoia and later: start the slackdump, OS will show the "Unknown developer" window, then go to System Preferences -> Security and Privacy -> General, and press "Open Anyway" button.
Getting Help
- Quickstart guide:
slackdump help quickstart, read online. - Generic command overview:
man ./slackdump.1 - Ez-Login 3000 Guide.
- What's new in V4:
slackdump help whatsnew, read online.
Running Slackdump from a Repo Checkout
If you've cloned the repository and want to run slackdump directly without downloading a release, you can do one of the following:
-
Build and run (creates an executable):
go build -o slackdump ./cmd/slackdump ./slackdump wiz -
Run directly:
go run ./cmd/slackdump wiz
Note: You need Go installed on your system (see go.mod for the version)
Slackord2: Migrating to Discord
If you're migrating to Discord, the recommended way is to use Slackord2 — a great tool with a nice GUI, that is compatible with the export files generated by Slackdump.
User Guide
For more advanced features and instructions, please see the User Guide,
and read slackdump help pages.
Previewing Results
Once the workspace data is dumped, you can run built-in viewer:
slackdump view <zip or directory>
The built-in viewer supports all types of dumps:
- Slackdump Archive format;
- Standard and Mattermost Slack Export;
- Dump mode files
You can also convert your output file to a browsable static HTML archive:
slackdump convert -f html -o my_html_archive <zip or directory>
or use one of the following tools to preview the export