$git clone https://github.com/rusq/slackdumpPurpose: archive your private and public Slack messages, users, channels, files and emojis. Generate Slack Export without admin privileges.
| 1 | # Slack Dumper |
| 2 | |
| 3 | Purpose: archive your private and public Slack messages, users, channels, |
| 4 | files and emojis. Generate Slack Export without admin privileges. |
| 5 | |
| 6 | [](https://github.com/rusq/slackdump/releases/) |
| 7 | |
| 8 | **Quick links**: |
| 9 | |
| 10 | - [Installation And Quickstart](#installation-and-quickstart) |
| 11 | - [Join the discussion in Telegram](https://t.me/slackdump). |
| 12 | - [Buy me a cup of tea](https://ko-fi.com/rusq_), or use **GitHub Sponsors** |
| 13 | button on the top of the page. |
| 14 | - [][godoc] |
| 15 | - [Using with AI Agents (MCP Server)](#slackdump-mcp-server) |
| 16 | - [Slack MCP Server (no permissions required)](https://github.com/korotovsky/slack-mcp-server) |
| 17 | - [Github CLI Slackdump extension](https://github.com/wham/gh-slackdump) |
| 18 | - How to's: |
| 19 | |
| 20 | - [Mattermost migration][mmost] steps |
| 21 | - [SlackLogViewerとSlackdumpを一緒に使用する](https://kenkyu-note.hatenablog.com/entry/2022/09/02/090949) |
| 22 | - [v1 Overview on Medium.com](https://medium.com/@gilyazov/downloading-your-private-slack-conversations-52e50428b3c2) (outdated) |
| 23 | |
| 24 | [godoc]: https://pkg.go.dev/github.com/rusq/slackdump/v4/ |
| 25 | [mmost]: doc/usage-export.md |
| 26 | [ug]: doc/README.md |
| 27 | |
| 28 | |
| 29 | > [!WARNING] |
| 30 | > # Enterprise Workspaces Security Alerts |
| 31 | > |
| 32 | > Depending on your Slack plan and security settings, using Slackdump may |
| 33 | > trigger Slack security alerts and/or notify workspace administrators of |
| 34 | > unusual or automated access/scraping attempts. |
| 35 | > |
| 36 | > You are responsible for ensuring your use complies with your organisation’s |
| 37 | > policies and Slack’s terms of service. |
| 38 | > |
| 39 | > **See [Enterprise Workspace Tips](doc/enterprise.md).** |
| 40 | |
| 41 | ## Description |
| 42 | |
| 43 | Typical use scenarios: |
| 44 | |
| 45 | * archive your private conversations from Slack when the administrator |
| 46 | does not allow you to install applications OR you don't want to use |
| 47 | potentially privacy-violating third-party tools; |
| 48 | * archive channels from Slack when you're on a free "no archive" subscription; |
| 49 | so you don't lose valuable knowledge in those channels; |
| 50 | * create a Slack Export archive without admin access; |
| 51 | * create incremental Slack archives, which is particularly useful for free |
| 52 | workspaces with 90-day limits; |
| 53 | * save your favourite emojis; AND |
| 54 | * analyse you Slack data with AI Agent using [Slackdump MCP Server](#slackdump-mcp-server). |
| 55 | |
| 56 | There are several modes of operation |
| 57 | |
| 58 | 1. List users/channels |
| 59 | 1. Dumping messages and threads |
| 60 | 1. Creating a Slack Export in Mattermost or Standard modes. |
| 61 | 1. Creating an Archive (Sqlite database or stored as json+gz) |
| 62 | 1. Converting an archive to other formats (Export, Dump). |
| 63 | 1. Emoji download mode. |
| 64 | 1. Viewing Slack export, dump or archive files or directories (displays images). |
| 65 | 1. Search mode (messages and files). |
| 66 | 1. Resuming previous archive (adding new messages to an existing archive). |
| 67 | 1. Local MCP Server to use with Opencode, Claude, or any other AI tool |
| 68 | supporting mcp over STDIO or HTTP. |
| 69 | 1. Database tools: merge multiple archives, remove duplicates, and clean up |
| 70 | unfinished sessions (`slackdump tools merge/dedupe/cleanup`). |
| 71 | |
| 72 | Run `slackdump help` to see all available options. |
| 73 | |
| 74 | ## Installation and Quickstart |
| 75 | |
| 76 | On macOS, you can install Slackdump with Homebrew: |
| 77 | |
| 78 | ```shell |
| 79 | brew install slackdump |
| 80 | ``` |
| 81 | |
| 82 | On other Operating Systems, please follow these steps: |
| 83 | |
| 84 | 1. Download the latest release for your operating system from the [releases] page. |
| 85 | 1. Unpack the archive to any directory. |
| 86 | 1. Run the `./slackdump` or `slackdump.exe` executable (see note below). |
| 87 | 1. You know the drill: use arrow keys to select the menu item, and Enter (or |
| 88 | Return) to confirm. |
| 89 | 1. Follow these [quickstart instructions][man-quickstart]. |
| 90 | |
| 91 | [releases]: https://github.com/rusq/slackdump/releases/ |
| 92 | |
| 93 | > [!NOTE] |
| 94 | > On Windows and macOS you may be presented with "Unknown developer" window, |
| 95 | > this is fine. Reason for this is that the executable hasn't been signed by |
| 96 | > the developer certificate. |
| 97 | |
| 98 | To work around this: |
| 99 | |
| 100 | - **on Windows**: click "more information", and press "Run |
| 101 | Anyway" button. |
| 102 | - **on |