The complete developer reference for TimeTrack — an open-source time tracking SaaS. Track time, manage projects, automate billing, and integrate with your stack via REST API or MCP.
TimeTrack is a self-hostable, open-source time tracking platform built for teams. It provides everything you need to track billable hours, manage projects, generate reports, and bill clients — with a modern stack and a developer-first API.
Persistent timer, manual entry, idle detection, and overtime warnings. One-click start/stop from anywhere in the app.
Summary, detailed, weekly, and attendance reports. Cost analysis by project or user. CSV export for accounting.
Hierarchical projects with tasks, budgets, and team assignments. Clients and member management built in.
Built-in subscription management with Stripe Checkout. API key access with usage tracking and rate limits.
Modern auth with social login, MFA, and JWT verification. No password management headaches.
Frontend available in English, Spanish, and Galician. API responses are language-agnostic.
Built-in Model Context Protocol server for AI assistants. Manage time, projects, and tasks from Claude or ChatGPT.
63 documented endpoints under /api/v1. OpenAPI 3.1 spec available. Bearer token authentication.
Single-command deploy with Docker Compose. Pre-built images available on the Cargoffer registry.
TimeTrack uses battle-tested, modern technologies. No proprietary lock-in — you can self-host, fork, or contribute.
Python 3.12, FastAPI 0.115, Motor (async MongoDB), Redis caching, Stripe SDK. Async-first architecture.
MongoDB 7 with optimized indexes. Collections for users, organizations, projects, time entries, and more.
React 19, Vite 6, TypeScript, Tailwind, shadcn/ui, Zustand state, PWA-capable.
Static frontend deployed via Cloudflare Pages with GitHub Actions for auto-deploy on push.
Set up TimeTrack locally in under 5 minutes. Docker Compose, environment variables, and first steps.
Complete reference for all 63 endpoints. Method, path, parameters, request body, and responses.
Connect TimeTrack with Stripe, Clerk, MCP-compatible AI assistants, and your own tools.
Machine-readable documentation optimized for LLMs. Point your AI assistant at this for context.
OpenAPI 3.1 specification. Import into Postman, Insomnia, or generate client SDKs automatically.
XML sitemap for search engines and AI crawlers. Lists all discoverable pages on this docs site.
TimeTrack fits a variety of workflows. Here are some common patterns.
Track billable hours across multiple clients, generate detailed reports for invoicing, and manage contractor rates. The Stripe integration handles subscription billing for recurring retainers.
Track time spent on features, bugs, and maintenance. Use the Pomodoro endpoint for focused work sessions. Connect to your issue tracker via webhooks.
Simple time tracking with invoicing built in. Use the API to integrate with your existing tools — Toggl-style workflows or fully custom pipelines.
The MCP server lets Claude, ChatGPT, or any MCP-compatible assistant manage your time entries, projects, and tasks. Ask your AI to "log 2 hours on the Acme project" and it just works.