Introduction

Timekeeper V2 is an enterprise-grade Discord time tracking bot with ML-powered analytics, designed for businesses, RP servers, and productive communities.

📘 New to Timekeeper?

Start with our Quick Start Guide below to get up and running in minutes.

What is Timekeeper V2?

Timekeeper V2 is the spiritual successor to the original Timekeeper bot, rebuilt from the ground up with enterprise reliability patterns and advanced analytics capabilities. It helps Discord communities track time across various activities, analyze productivity patterns, and make data-driven decisions.

Key Highlights

  • Smart Clock System - Clock in/out with Discord role integration and multi-category support
  • ML-Powered Analytics - Advanced machine learning models analyze work patterns and provide insights
  • Enterprise Architecture - Built with Redis, multi-layer caching, and circuit breaker patterns
  • Real-Time Monitoring - Track active sessions and view live dashboards
  • Flexible Export - Export data in CSV, PDF, and DOCX formats
  • API Access - Tiered API system for custom integrations

Who Should Use Timekeeper?

Businesses
Track employee hours, monitor project time, and generate reports for billing and payroll.
RP Servers
Track roleplay sessions, manage character activity, and maintain engagement leaderboards.
Communities
Gamify productivity, run competitions, and track community engagement metrics.

Quick Start

Get started with Timekeeper in three simple steps:

  1. Invite the Bot - Add Timekeeper to your Discord server using the invite link
  2. Configure Categories - Use /admin categories add to set up tracking categories
  3. Start Tracking - Users can begin with /clockin <category>
✅ Ready to go!

That's all you need to start tracking time. Explore more features in the Commands and Features sections.

Server Setup

After inviting Timekeeper, administrators should configure the following:

1. Set Up Categories

/admin categories add name:Development
/admin categories add name:Meetings
/admin categories add name:Design

2. Configure Permissions (Optional)

By default, all users can track time. You can restrict access using the permission system:

/config permissions set role:@Staff can_track:true
/config permissions set role:@Everyone can_track:false

3. Enable Analytics (Optional)

Unlock ML-powered insights for your server:

/config analytics enabled:true
⚠️ Important Note

Timekeeper requires the "Manage Roles" permission to automatically assign roles when users clock in. Make sure the bot role is positioned above any roles it needs to manage.

Next Steps

Commands Reference
Explore all available commands with detailed examples and parameter descriptions.
Features Guide
Deep dive into ML analytics, data export, leaderboards, and enterprise features.
API Documentation
Build custom integrations with code examples in Python, JavaScript, TypeScript, and Rust.