Tiny Telegram Tools

Freelancer time tracker bot for Telegram

Clock in/out or log hours by DM, totaled per client.

Hours tracks freelance time from your DM with the bot. /in starts a running clock for a client, /out stops it and logs the elapsed time; or skip the clock entirely and log a block of time directly with /log.

/week and /month total your logged hours, split out per client so you can see where your time went. Pro sets an hourly /rate per client and turns unbilled entries into an invoice with a CSV attached via /invoice.

Use it without adding the bot

Use it without adding the bot: type @TimeSheetProBot 2h15m acme in any chat and it posts the billable line — add an hourly rate, like 2h15m acme 60, to see the amount too.

Commands

CommandExampleDoes
/in/in acme fix the bugStart the clock for a client (client name required, task note optional).
/out/outStop the running clock and log the elapsed time to the client you clocked in for.
/log/log 2h acme redesignLog a block of time directly without clocking in/out: duration, client, and a task note.
/trend/trendFree: a sparkline of your logged minutes over the last 7 days — your week at a glance.
/week/weekHours logged this week, totaled per client.
/month/monthHours logged this month, totaled per client.
/rate/rate acme 60Pro only: set an hourly rate for a client, used by /invoice.
/invoice/invoice acmePro only: DM you an invoice (plus a CSV attachment) for that client's unbilled hours since the last invoice; requires /rate to be set first.
/pro/proUnlock invoicing, rates, and full history for a one-time 150 Stars payment.

All TimeSheetProBot commands

Free vs Pro

Free

  • 2 clients, current month only
  • /week and /month totals per client
  • /in /out clock plus /log for manual entries

Pro — 150 Stars (≈ $3), one-time, per user

  • Unlimited clients and full history
  • Hourly /rate per client
  • /invoice with a CSV attached, per client

Privacy

See the full privacy page for what every bot in Tiny Telegram Tools stores.

FAQ

Do I have to clock in and out, or can I log time after the fact?
Either — use /in and /out to track a session live, or skip that and log a completed block directly with /log, e.g. "/log 2h acme redesign".
What happens if I forget to /out?
If you stay clocked in past 10 hours, the bot DMs you a reminder; the clock keeps running until you send /out.
How are totals split by client?
Every /in, /out, and /log entry carries a client name (required on /in and /log), so /week and /month can total hours per client instead of just one lump sum.
How does invoicing work?
Set an hourly rate once with /rate acme 60, then run /invoice acme — Pro only. It totals unbilled hours for that client since your last invoice and sends the invoice text plus a CSV attachment.
What does Pro add?
Unlimited clients and full history, /rate to set an hourly rate per client, and /invoice with a CSV attached, either as a one-time 150 Stars payment or a 100 Stars/month subscription.

Related guides

Other bots