How to use TempusLog
Short how-tos for the things people ask most. Can't find it? Email contact@mile.dev.
Start a timer
- Open Track. In the bar at the top, type what you are working on.
- Pick a project (and a task or tags if you use them). The $ button marks the time as billable.
- Press Start. The timer keeps running when you close the tab or switch devices.
- Press Stop when you are done. Timers shorter than a minute are discarded, with an Undo.
Add time afterwards
- Type a duration in the timer field, like 1h30, 90m, 1.5 or 1:30, and press Add.
- Or switch the bar to Manual entry (the list icon next to the timer) to set the date, start and end.
- On the calendar, drag over empty time to add an entry, or drag an entry to move it.
- After you add one, the next entry starts where it ended, with the same length.
Change or delete an entry
- Click any part of an entry and change it. It saves as soon as you leave the field.
- On a phone, tap the entry to open it, then change it or tap Delete.
- The play button on a past entry is Track again: a new timer with the same task.
Invite your team
- Open Team and use Invite people. Add one or more email addresses.
- Each person gets an email and joins with Google or a password.
- Admins manage everything except owner-only actions. Members log their own time on the projects they can access.
Choose who sees a project
- Open Projects, then the project, then Access.
- Add people (also people who haven't accepted their invite yet) and remove them any time.
- Owners and admins can make someone a Project admin: they manage the project's Members and log time for them.
- To log time for someone, press the initials button at the end of the Track bar's buttons and pick them. It turns sand colored and the calendar shows their time until you go back to yours.
Reports and exports
- Open Reports. Summary groups time by project, client, person, task or tag. Detailed lists every entry.
- Pick a range (This week, Last month, This year, or Custom) and filter by person, client, project, task, tag or billable.
- Press Export CSV or Export PDF. The export uses the same range and filters.
Import from Clockify
- Open Settings, then Import from Clockify (owner and admins only).
- Paste a Clockify API key, or upload a Detailed report CSV.
- Step by step with screenshots: Import from Clockify.
Add TempusLog to your phone
- iPhone: open tempuslog.com in Safari, tap Share, then Add to Home Screen.
- Android: open tempuslog.com in Chrome, tap the menu, then Add to Home screen or Install app.
Connect an AI app
- Claude: in Settings, open Connectors, add a custom connector and paste https://tempuslog.com/mcp.
- ChatGPT: open Plugins, then Add, then Create MCP App. Paste https://tempuslog.com/mcp and press Connect.
- Log in to TempusLog when it asks, pick Read only or Read and log time, and press Allow.
- Cursor, VS Code, Claude Code and Codex: open Settings, AI apps in TempusLog for a one click button or the command to paste.
- To disconnect, press Disconnect next to the app in Settings, AI apps. More on the AI page.
API keys
- Open Settings, API keys and press Create API key. Pick Read only or Read and write.
- Copy the key right away. It's shown only once.
- Delete a key in the same place and it stops working at once. Endpoints and examples: API docs.
Your account
- Your timezone is taken from your browser the first time you sign in. Change it in Settings, Your account, Timezone.
- Download everything you logged as a file with Download my data in Settings, Your account.
- Delete your account yourself in Settings, Your account.
- Forgot your password? Use Forgot password on the login page.
Your workspace
- Owners can hand the workspace to another member in Settings, Ownership.
- Owners can delete the workspace with all its projects and time in Settings, Ownership. You type its name to confirm.