# Rocket.Chat userlist exporter

**URL:** <https://forums.rocket.chat/t/rocket-chat-userlist-exporter/470>\
**Category:** Community Creations\
**Created:** [April 4, 2018, 11:26am UTC](https://forums.rocket.chat/t/rocket-chat-userlist-exporter/470 "2018-04-04T11:26:32Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![frdmn](https://sea1.discourse-cdn.com/flex021/user_avatar/forums.rocket.chat/frdmn/32/198_2.png) [@frdmn](https://forums.rocket.chat/u/frdmn)\
**Post date:** [April 4, 2018, 11:26am UTC](https://forums.rocket.chat/t/rocket-chat-userlist-exporter/470/1 "2018-04-04T11:26:32Z")

</div>

Hallo!

since the question came up fairly often (in [#support](https://open.rocket.chat/channel/support) channel) how to export a _complete_ userlist without interacting in the administration UI, I’ve build a simple CLI tool called `rocketchat-export-userlist`:

> **[frdmn/rocketchat-export-userlist](https://github.com/frdmn/rocketchat-export-userlist)**
>
> 🚀 Simple Node CLI tool to export a complete user list of a Rocket.Chat server as CSV (or JSON) file - frdmn/rocketchat-export-userlist

It makes use of the great NodeJS API client by [qeesung](https://github.com/qeesung/rocketchat-node) and writes the all the important user data (name, username, mail address(es), mail verification status, presence status, etc.) in a export file in CSV format (or JSON):

 ![68747470733a2f2f692e696d6775722e636f6d2f6a72305153686c2e706e67](https://us1.discourse-cdn.com/flex021/uploads/rocketchat/original/1X/d47f9c3be6198bac7565ea7df09638ee546b50bb.png)

Please note that this is a community creation and nothing officially supported by Rocket.Chat itself, therefor not in the GitHub namespace of Rocket.Chat.

If you have any suggestions, improvement or feature request feel free to comment here or open an issue on GitHub.

Jonas.

---

<div class="post-metadata">

**Author:** ![aaron.ogle](https://sea1.discourse-cdn.com/flex021/user_avatar/forums.rocket.chat/aaron.ogle/32/15_2.png) [@aaron.ogle](https://forums.rocket.chat/u/aaron.ogle)\
**Post date:** [April 4, 2018, 4:00pm UTC](https://forums.rocket.chat/t/rocket-chat-userlist-exporter/470/2 "2018-04-04T16:00:19Z")

</div>

@frdmn this is awesome!! You are right many have looked for a way to do this. We’ve often had to suggest the API, but many aren’t familiar enough with the API. This removes that complexity for them. So this is perfect! Thanks for sharing!

---

<div class="post-metadata">

**Author:** ![Allison](https://sea1.discourse-cdn.com/flex021/user_avatar/forums.rocket.chat/allison/32/1021_2.png) [@Allison](https://forums.rocket.chat/u/Allison)\
**Post date:** [January 30, 2020, 2:33am UTC](https://forums.rocket.chat/t/rocket-chat-userlist-exporter/470/3 "2020-01-30T02:33:08Z")

</div>

In the case of a 3-node replica set, I assume the CLI exporter is run on the Primary Database?

Can someone please confirm or advise otherwise?