Skip to content
Back to search

slackdump

Save or export your private and public Slack messages, threads, files, and users locally without admin privileges.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/rusq/slackdump with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/rusq/slackdump'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rusq--slackdump/badge.svg)](/listings/rusq--slackdump)

HTML

<a href="/listings/rusq--slackdump"><img src="/api/listings/rusq--slackdump/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

On macOS, you can install Slackdump with Homebrew:

brew install slackdump

On other Operating Systems, please follow these steps:

1. Download the latest release for your operating system from the [releases] page. 1. Unpack the archive to any directory. 1. Run the `./slackdump` or `slackdump.exe` executable (see note below). 1. You know the drill: use arrow keys to select the menu item, and Enter (or Return) to confirm. 1. Follow these [quickstart instructions][man-quickstart].

[releases]: https://github.com/rusq/slackdump/releases/

> [!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][man-quickstart]. - Generic command overview: `man ./slackdump.1` - [Ez-Login 3000](https://github.com/rusq/slackdump/wiki/EZ-Login-3000) Guide. - What's new in V4: `slackdump help whatsnew`, read [online][man-changelog].

[man-quickstart]: https://github.com/rusq/slackdump/blob/master/cmd/slackdump/internal/man/assets/quickstart.md [man-changelog]: https://github.com/rusq/slackdump/blob/master/cmd/slackdump/internal/man/assets/changelog.md

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 350 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Slack Dumper
  2. Purpose: archive your private and public Slack messages, users, channels,
  3. files and emojis. Generate Slack Export without admin privileges.
  4. [![Slackdump screenshot](doc/slackdump.webp)](https://github.com/rusq/slackdump/releases/)
  5. **Quick links**:
  6. - [Installation And Quickstart](#installation-and-quickstart)
  7. - [Join the discussion in Telegram](https://t.me/slackdump).
  8. - [Buy me a cup of tea](https://ko-fi.com/rusq_), or use **GitHub Sponsors**
  9. button on the top of the page.
  10. - [![Go reference](https://pkg.go.dev/badge/github.com/rusq/slackdump/v4.svg)][godoc]
  11. - [Using with AI Agents (MCP Server)](#slackdump-mcp-server)
  12. - [Slack MCP Server (no permissions required)](https://github.com/korotovsky/slack-mcp-server)
  13. - [Github CLI Slackdump extension](https://github.com/wham/gh-slackdump)
  14. - How to's:
  15. - [Mattermost migration][mmost] steps
  16. - [SlackLogViewerとSlackdumpを一緒に使用する](https://kenkyu-note.hatenablog.com/entry/2022/09/02/090949)
  17. - [v1 Overview on Medium.com](https://medium.com/@gilyazov/downloading-your-private-slack-conversations-52e50428b3c2) (outdated)
  18. [godoc]: https://pkg.go.dev/github.com/rusq/slackdump/v4/
  19. [mmost]: doc/usage-export.md
  20. [ug]: doc/README.md
  21. > [!WARNING]
  22. > # Enterprise Workspaces Security Alerts
  23. >
  24. > Depending on your Slack plan and security settings, using Slackdump may
  25. > trigger Slack security alerts and/or notify workspace administrators of
  26. > unusual or automated access/scraping attempts.
  27. >
  28. > You are responsible for ensuring your use complies with your organisation’s
  29. > policies and Slack’s terms of service.
  30. >
  31. > **See [Enterprise Workspace Tips](doc/enterprise.md).**
  32. ## Description
  33. Typical use scenarios:
  34. * archive your private conversations from Slack when the administrator
  35. does not allow you to install applications OR you don't want to use
  36. potentially privacy-violating third-party tools;
  37. * archive channels from Slack when you're on a free "no archive" subscription;
  38. so you don't lose valuable knowledge in those channels;
  39. * create a Slack Export archive without admin access;
  40. * create incremental Slack archives, which is particularly useful for free
  41. workspaces with 90-day limits;
  42. * save your favourite emojis; AND
  43. * analyse you Slack data with AI Agent using [Slackdump MCP Server](#slackdump-mcp-server).
  44. There are several modes of operation
  45. 1. List users/channels
  46. 1. Dumping messages and threads
  47. 1. Creating a Slack Export in Mattermost or Standard modes.
  48. 1. Creating an Archive (Sqlite database or stored as json+gz)
  49. 1. Converting an archive to other formats (Export, Dump).
  50. 1. Emoji download mode.
  51. 1. Viewing Slack export, dump or archive files or directories (displays images).
  52. 1. Search mode (messages and files).
  53. 1. Resuming previous archive (adding new messages to an existing archive).
  54. 1. Local MCP Server to use with Opencode, Claude, or any other AI tool
  55. supporting mcp over STDIO or HTTP.
  56. 1. Database tools: merge multiple archives, remove duplicates, and clean up
  57. unfinished sessions (`slackdump tools merge/dedupe/cleanup`).
  58. Run `slackdump help` to see all available options.
  59. ## Installation and Quickstart
  60. On macOS, you can install Slackdump with Homebrew:
  61. ```shell
  62. brew install slackdump
  63. ```
  64. On other Operating Systems, please follow these steps:
  65. 1. Download the latest release for your operating system from the [releases] page.
  66. 1. Unpack the archive to any directory.
  67. 1. Run the `./slackdump` or `slackdump.exe` executable (see note below).
  68. 1. You know the drill: use arrow keys to select the menu item, and Enter (or
  69. Return) to confirm.
  70. 1. Follow these [quickstart instructions][man-quickstart].
  71. [releases]: https://github.com/rusq/slackdump/releases/
  72. > [!NOTE]
  73. > On Windows and macOS you may be presented with "Unknown developer" window,
  74. > this is fine. Reason for this is that the executable hasn't been signed by
  75. > the developer certificate.
  76. To work around this:
  77. - **on Windows**: click "more information", and press "Run
  78. Anyway" button.
  79. - **on macOS** 14 Sonoma and prior: open the folder in Finder, hold Option
  80. and double click the executable, choose Run.
  81. - **on macOS** 15 Sequoia and later: start the slackdump, OS will show the
  82. "Unknown developer" window, then go to System Preferences -> Security and
  83. Privacy -> General, and press "Open Anyway" button.
  84. ### Getting Help
  85. - Quickstart guide: `slackdump help quickstart`, read [online][man-quickstart].
  86. - Generic command overview: `man ./slackdump.1`
  87. - [Ez-Login 3000](https://github.com/rusq/slackdump/wiki/EZ-Login-3000) Guide.
  88. - What's new in V4: `slackdump help whatsnew`, read [online][man-changelog].
  89. [man-quickstart]: https://github.com/rusq/slackdump/blob/master/cmd/slackdump/internal/man/assets/quickstart.md
  90. [man-changelog]: https://github.com/rusq/slackdump/blob/master/cmd/slackdump/internal/man/assets/changelog.md
  91. ## Running Slackdump from a Repo Checkout
  92. If you've cloned the repository and want to run slackdump directly without downloading a release, you can do one of the following:
  93. 1. **Build and run** (creates an executable):
  94. ```shell
  95. go build -o slackdump ./cmd/slackdump
  96. ./slackdump wiz
  97. ```
  98. 2. **Run directly**:
  99. ```shell
  100. go run ./cmd/slackdump wiz
  101. ```
  102. Note: You need Go installed on your system (see `go.mod` for the version)
  103. ## Slackord2: Migrating to Discord
  104. If you're migrating to Discord, the recommended way is to use
  105. [Slackord2](https://github.com/thomasloupe/Slackord2) — a great tool with a
  106. nice GUI, that is compatible with the export files generated by Slackdump.
  107. ## User Guide
  108. For more advanced features and instructions, please see the [User Guide][ug],
  109. and read `slackdump help` pages.
  110. # Previewing Results
  111. Once the workspace data is dumped, you can run built-in viewer:
  112. ```shell
  113. slackdump view <zip or directory>
  114. ```
  115. The built-in viewer supports all types of dumps:
  116. 1. Slackdump Archive format;
  117. 1. Standard and Mattermost Slack Export;
  118. 1. Dump mode files
  119. You can also convert your output file to a browsable static HTML archive:
  120. ```bash
  121. slackdump convert -f html -o my_html_archive <zip or directory>
  122. ```
  123. or use one of the following tools to preview the export results:
  124. - [SlackLogViewer] - a fast and powerful Slack Export viewer written in C++, works on Export files (images won't be displayed, unless you used an export token flag).
  125. - [Slackdump2Html] - a great Python application that converts Slack Dump to a
  126. static browsable HTML. It works on Dump mode files.
  127. - [slack export viewer][slack-export-viewer] - Slack Export Viewer is a well known viewer for
  128. slack export files. Supports displaying files if saved in the "Standard" file mode.
  129. [SlackLogViewer]: https://github.com/thayakawa-gh/SlackLogViewer/releases
  130. [Slackdump2Html]: https://github.com/kununu/slackdump2html
  131. [slack-export-viewer]: https://github.com/hfaran/slack-export-viewer
  132. # Slackdump MCP server
  133. Slackdump offers a read-only MCP server with the following features:
  134. - analyse the data in the archive (any type)
  135. - provide help with command line flags
  136. Available MCP tools:
  137. | Tool | Description |
  138. |------|-------------|
  139. | `load_source` | Open (or switch to) a Slackdump archive at runtime |
  140. | `list_channels` | List all channels in the archive |
  141. | `get_channel` | Get detailed info for a channel by ID |
  142. | `list_users` | List all users/members |
  143. | `get_messages` | Read messages from a channel (paginated) |
  144. | `get_thread` | Read all replies in a thread |
  145. | `get_workspace_info` | Workspace/team metadata |
  146. | `command_help` | Get CLI flag help for any slackdump subcommand |
  147. The server supports both **stdio** (agent-managed) and **HTTP** transports.
  148. ### Quick project setup
  149. Scaffold a ready-to-use project directory pre-configured for your AI tool:
  150. ```shell
  151. slackdump mcp -new opencode ~/my-slack-project # OpenCode
  152. slackdump mcp -new claude-code ~/my-slack-project # Claude Code
  153. slackdump mcp -new copilot ~/my-slack-project # VS Code / GitHub Copilot
  154. slackdump mcp -new codex ~/my-slack-project # Codex
  155. ```
  156. Each command creates the MCP config file and installs bundled Slackdump skill /
  157. instruction files so the agent knows how to work with your archive out of the box.
  158. To learn how to set it up with Codex, Claude Desktop, VS Code/GitHub Copilot,
  159. or OpenCode, see:
  160. ```
  161. slackdump help mcp
  162. ```
  163. or refer to the [Slackdump MCP command help page][mcp-doc].
  164. [mcp-doc]: https://github.com/rusq/slackdump/blob/master/cmd/slackdump/internal/mcp/assets/mcp.md
  165. ## Using as a library
  166. Download:
  167. ```shell
  168. go get github.com/rusq/slackdump/v4
  169. ```
  170. ### Example
  171. ```go
  172. package main
  173. import (
  174. "context"
  175. "log"
  176. "github.com/rusq/slackdump/v4"
  177. "github.com/rusq/slackdump/v4/auth"
  178. )
  179. func main() {
  180. provider, err := auth.NewValueAuth("xoxc-...", "xoxd-...")
  181. if err != nil {
  182. log.Print(err)
  183. return
  184. }
  185. sd, err := slackdump.New(context.Background(), provider)
  186. if err != nil {
  187. log.Print(err)
  188. return
  189. }
  190. _ = sd
  191. }
  192. ```
  193. See [Package Documentation][godoc].
  194. ### Using Custom Logger
  195. Slackdump uses a "log/slog" package, it defaults to "slog.Default()". Set the
  196. default slog logger to the one you want to use.
  197. If you were using `logger.Silent` before, you would need to
  198. [implement][slog-handler-guide] a discarding [Handler][godoc-slog-handler] for slog.
  199. [slog-handler-guide]: https://github.com/golang/example/blob/master/slog-handler-guide/README.md
  200. [godoc-slog-handler]: https://pkg.go.dev/log/slog#Handler
  201. ## FAQ
  202. #### Do I need to create a Slack application?
  203. No, you don't. Just run the application and EZ-Login 3000 will take
  204. care of the authentication or, alternatively, grab that token and
  205. cookie from the browser Slack session. See [User's Guide][ug].
  206. #### I'm getting "invalid_auth" error
  207. Run `slackdump workspace new <name or url>` to reauthenticate.
  208. #### How to read the export file?
  209. ```shell
  210. slackdump view <ZIP-archive or directory>
  211. ```
  212. #### My Slack Workspace is on the Free plan. Can I get data older than 90-days?
  213. No, unfortunately you can't. Slack doesn't allow to export data older than 90
  214. days for free workspaces, the API does not return any data before 90 days for
  215. workspaces on the Free plan.
  216. #### What's the difference between "archive", "export" and "dump"?
  217. "Archive" is the new format introduced in v3, it minimises the memory use
  218. while scraping the data and also has a universal structure that can be
  219. converted into export and dump formats at will by using the "convert" command.
  220. "Export" format aims to replicate the files generated when exporting a Slack
  221. workspace for compatibility.
  222. "Dump" format has one channel per file, there's no workspace information nor
  223. any users stored. Should it be required, one must get users and channels by
  224. running `slackdump list` command.
  225. Behind the scenes slackdump always uses the "archive" file format for all
  226. operations except "emoji" and "list", and converts to other formats on the
  227. fly, removing the temporary archive files afterwards.
  228. ## Thank you
  229. Big thanks to all contributors, who submitted a pull request, reported a bug,
  230. suggested a feature, helped to reproduce, or spent time chatting with me on
  231. the Telegram or Slack to help to understand the problem or feature and tested
  232. the proposed solution.
  233. See CONTRIBUTORS.md for the full list of contributors.
  234. Also, I'd like to thank current sponsors:
  235. - [<img class="avatar avatar-user" src="https://avatars.githubusercontent.com/u/9138285?s=60&amp;v=4" width="30" height="30" alt="@malsatin">](https://github.com/malsatin) @malsatin
  236. - [<img class="avatar avatar-user" src="https://avatars.githubusercontent.com/u/836183?s=60&amp;v=4" width="30" height="30" alt="@angellk">](https://github.com/angellk) @angellk
  237. And everyone who made a donation to support the project in the past and keep
  238. supporting the project:
  239. - Davanum S.
  240. - Vivek R.
  241. - Fabian I.
  242. - Ori P.
  243. - Shir B. L.
  244. - Emin G.
  245. - Robert Z.
  246. - Sudhanshu J.
  247. ## License
  248. Slackdump is licensed under the [GNU Affero General Public License v3.0 (AGPLv3)](LICENSE).
  249. # Bulletin Board
  250. Messages that were conveyed with the donations:
  251. - 25/01/2022: Stay away from [TheSignChef.com][glassdoor], ya hear, they don't
  252. pay what they owe to their employees.
  253. [glassdoor]: https://www.glassdoor.com/Reviews/The-Sign-Chef-Reviews-E1026706.htm

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.