DiscordCleanerBot is the essential tool for server owners and moderators looking to efficiently manage member activity, maintain a vibrant community, and ensure your server thrives.This intelligent bot automates the process of identifying, reporting on, reminding, and ultimately kicking inactive users, freeing up your time and keeping your member list fresh. It's designed to promote engagement and streamline server administration by gently nudging inactive members or, when necessary, automatically removing them.Clean up your server. Boost engagement. Automate moderation.

“The bot made managing my server much easier and made scaling much more feasible.” -- Cobra808, 20+ member gaming community“Pretty useful to keep the group in check.” -- 19azrael90“Excellent server and bot!” -- misterkermit"Super useful bot for my server, lots of handy features to save some time!"
-- idk9831

Changelog

Release Notes - v1.2.3 - 16.07.2025🐛 Bug Fixes
+ fixed an issue with very long channel lists (with > 6,000 characters per result, which exceeds discord's limits) in /config check_permissions

________________________________________________________________________________

Release Notes - v1.2.2 - 15.07.2025🐛 Bug Fixes
+ fixed missing localization strings
+ fixed an issue with Spanish localization strings, whereof one was too long for discord's limits
+ fixed a CommandInvokeError for exempt roles🚀 Improvements
+ made the /start onboarding wizard much more stable and frictionless working with proper content validation and guidance

________________________________________________________________________________

Release Notes - v1.2.1 - 14.07.2025✨New Features
+ added a sparkling setup wizard. Just use /start and you’ll be fully guided
+ added a new command /terms in order to fullfil discord's requirements for bots active on 100+ servers🐛 Bug Fixes
+ fixed a NoneType error while inactivity scan is running and the bot has been removed from a guild🚀 Improvements
+ made commands clickable in /help and during /config setup guide
+ reactivated the welcome message on “bot joined guild” event to the guild’s system channel or, as a fallback, via DM to the guild owner
+ optimized hint on non-accessible channels and advised to whitelist channels, the bot should not be able to read⚠️ Known Issues
+ in the /start wizard, configurations are immediately stored, not waiting for confirmation. it's not a defect, it's just bad UX - I'll fix this with the next release

________________________________________________________________________________

Release Notes - v1.2.0 - 13.07.2025✨New Features
+ added a new premium feature called "time zone conversion"
+ added a new command /features which lists and explains all premium tools and features. here you can also find a detailed explanation of the time zone feature with /features feature:Time Zone Conversion🐛 Bug Fixes
+ with no effect to users: fixed error handling on bot reboot for not finding top.gg to ping guild count
+ fixed a critical TypeError in the main bot script
+ fixed an issue in the internal bot health script not reporting events
+ fixed issues with discord's "rate limited" while reading channel histories
+ fixed an issue for /help and some localizations (texts were too long, exceeding discord's limits)🚀 Improvements
+ dramatically reduced the bot's downtime on bot reboot (during releases) by 99%
+ dramatically reduced periodic inactivity scans by starting scans for all guilds in parallel, not sequentially

________________________________________________________________________________

Release Notes - v1.1.3 - 12.07.2025🐛 Bug Fixes
+ fixed the error handling and an unhandled exception, when a command failed
+ fixed the /reportinactivity command not working, if the member's list is too long and the messages to be send exceeds discord's 4096 character limit for embed descriptions.⚠️ Known Issues
* with no effect to users: already fixed error handling on bot reboot for not finding top.gg and ping guild count; will be released with next release

________________________________________________________________________________

Release Notes - v1.1.2 - 09.07.2025🐛 Bug Fixes
* fixed an issue which occurred in inactivity scanning🚀 Improvements
* added uptime monitoring capabilities

________________________________________________________________________________

Release Notes - v1.1.1 - 08.07.2025🐛 Bug Fixes
+ fixed an issue while logging🚀 Improvements
+ removed the welcome message sent to a public channel, as the bot reminds staff members on incomplete configuration during its lifetime automatically.
+ extended /help command and integrated a "howto setup" section.

________________________________________________________________________________

Release Notes - v1.1.0 - 06.07.2025✨New Features
+ added new commands /config clear_default_roles and /config clear_exempt_roles to enable users to clear a list of roles: if a role has been removed, it cannot be selected from a drop-down list, so the list needs to be reset and newly created with /config add_*🐛 Bug Fixes
+ fixed the missing deletion of a guild's entitlement cache when it removed the bot.🚀 Improvements
+ extended / rephrased text messages and notifications for better user experience
+ added a delay of 24h for entitlements (premium) checks on bot reboot. This avoids too frequently checks, which are foreseen to be done just once a day.
+ added additional system logging in order to verify, features are working well.
+ added cleanup logic for member activity and entitlement cache data on bot reboot, besides already existing guild configuration checks.

________________________________________________________________________________

Release Notes - v1.0.8 - 06.07.2025🐛 Bug Fixes
+ fixed an issue with automatic functions for freemium users
+ fixed in issue with localization strings during periodical license checks🚀 Improvements
+ removed command prefix "!" comletely
+ extended logging for license handling

________________________________________________________________________________

Release Notes - v1.0.7 - 05.07.2025🚀 Improvements
+ activated top.gg integration to push server count

________________________________________________________________________________

Release Notes - v1.0.6 - 04.07.2025🐛 Bug Fixes
+ fixed "incomplete setup" notification not initiated once per week
+ fixed guildtiers + checkpremium command issue leading to an NoneType error

________________________________________________________________________________

Release Notes - v1.0.5 - 02.07.2025🐛 Bug Fixes
+ fixed "incomplete setup" notification not initiated once per week (hopefully)🚀 Improvements
+ added top.gg libary and pushing server counts to them
+ disabled traditional prefix commands support (like !), as slash commands are used
+ reduced logging amount on backend side
+ completely refactored the /help command and removed /about and /list_commands; a list of commands can now be found in /help

________________________________________________________________________________

**Release Notes - v1.0.4 - 01.07.2025 **🐛 Bug Fixes
+ fixed an issue on wrong app commands sent to the bot, leading to TypeErrors🚀 Improvements
+ optimised the auto-reponse for direct messaging to the bot
+ if bot configuration becomes or stays incomplete: added a staff notification (limited to once per week), with a fallback message to the guild owner, if (and only if) staff channel is not specified or bot has no rights to post there

________________________________________________________________________________

Release Notes - v1.0.3 - 29.06.2025✨New Features
+ added config section for whitelisting channels, which are not being scanned for activities > if properly configured, this will avoid annoying "missing channel permission" warnings, if specific channels should not be scanned at all. start with /config add_whitelisted_channel⚠️ Known Issues
+ due to a larger database migration, guild settings got lost - which was not the case in the test environment. sorry for that! reconfigure the bot for your guild and it will work as expected again.

________________________________________________________________________________

Release Notes - v1.0.2 - 28.06.2025🐛 Bug Fixes
+ fixed the auto-default-role assignment on new member joins not working
+ fixed localization strings missing for several messages
+ fixed a TypeError in /checkpremium and other license related commands
+ fixed a TypeError with human member count🚀 Improvements
+ Increased the delay of the first inactivity-auto-check from 1h to 24h to not bother guilds with "setup incomplete" or "channel permission" warnings. Anyhow, the activity cache is filled in the background, which enables manual /reportinactivity reports.

💰 Freemium vs. Premium

  • Set It & Forget It: Automate inactivity checks, role assignments, and member kicking.

  • Stay in Control: Full manual commands for advanced control and insights.

  • Increase Engagement: Gently nudge inactive users to return and participate.

  • Cleaner Communities: Remove ghost members and improve member-to-engagement ratio.

  • Configurable & Scalable: Works for small hobbyist groups and massive Discord communities.

FeatureAll tiers
Manual inactivity report👍🏻
Fully automatic daily inactivity checks👍🏻
Auto role assignment + stripping👍🏻
Auto kicking after threshold👍🏻
Custom inactivity thresholds👍🏻
Whitelisting of channels (no activity scan)👍🏻
Export activity report👍🏻
Multi-language support👍🏻

  • freemium : free (up to 100 guild members)

  • pro : $ 1.99 / month (up to 1,000 guild members)

  • scale : $ 3.99 / month (1,000+ guild members)

🙋🏻 Frequently Asked Questions (FAQ)

Getting Started

  1. Go to https://discord.com/oauth2/authorize?client_id=1368223375364980746.

  2. Click "Invite" and select your server.

  3. Review and grant required permissions: Manage Roles, Kick Members, View Channels, Read Messages, Read Message History, Send Messages.

Set Bot Role Hierarchy

  1. In your Discord server, navigate to Server Settings -> Roles.

  2. Find the role named after your bot (e.g., "CleanerBot").

  3. Drag this role to a high position in the list, ideally just below your Administrator/Moderator roles. It must be above any roles it needs to manage (assign/strip) or members it might kick.

  4. Confirm its permissions include Manage Roles, Kick Members, View Channels, Read Messages, Read Message History, and Send Messages.

  5. Save Changes.

Configure Core Inactivity Settings

  1. Use /start to take advantage of a setup wizard, which will guide you through the process. You can also configure manually, if you want:

  2. Use the /config command or specific slash commands to tailor CleanerBot to your server. This is your main command to view and change most settings.

  3. Start with /config set_admin_role, the bot will guide you through the setup.

  4. To setup an inactivity threshold, where users receive an @inactive role, e.g., after 30 days, use /config set_inactivity_threshold days:30. Set a kick threshold of additional 30 days, use /config set_kick_threshold days:30, so that users are mentioned and receive a warning to the channel you've specified via /config set_warning_channel channel:xxx after being inactive since 30 days and automatically being kicked after overall 60 inactive days (another message is sent to that channel, informing about the kick due to inactivity). This will additional support engagement of other members, warning them about the auto-kick-feature, if not being active. It's simple as that. 🚀

  5. Validate and, if complete, finalize the configuration with /config validate. View your configuration via /config show at every time.

  6. Go through optional settings, like whitelisting channels the bot should not search nor watch for member's activities with /config add_whitelisted_channel or exclude roles from activity screening, e.g., admin roles, with /config add_exempt_role.

Run Your First Report

See your current inactive members before the bot starts its autonomous work 24h after initial setup, by typing /reportinactivity.

Other Useful Commands

  • /help: Get help with CleanerBot or report an issue.

  • /premium: Learn about CleanerBot's premium features and how to unlock them!

  • /checkpremium: Check the current premium status for your guild.

  • /lastactive: Shows the last known activity and join date for a member.

  • /exportactivity: Exports the activity cache as a CSV file.

  • /next_check: Shows the next scheduled run of the automatic inactivity check.

  • /guildtiers: View the member limits for each tier.

🫶🏻 Showcase : some real-life impressions

Some of the messages shown, like the inactivity warnings or kick notifications, are examples of what a guild member would typically see. These are standard, individualized communications from the bot to your members.