TaskTime Pro MCP server

TaskTime Pro

TaskTime Pro is a free, open-source, local-first work manager for freelancers, covering tasks, timers, expenses, invoices, and reports. Core use requires no TaskTime account or cloud sync, works offline after the PWA is loaded or installed, and stores work records in the browser.

Free includes one active client, unlimited projects and invoices, PDF downloads, and the current-month Reports Overview. The optional Pro plan adds unlimited active clients, advanced reports, and hosted email sending.

The app stores user work data locally with Yjs and IndexedDB, supports optional Google Drive or Dropbox sync, and exposes an optional first-party same-device MCP bridge for AI agents after explicit pairing. The production app sends limited aggregate usage metrics without project, task, client, invoice, expense, note, or time-entry content.

• Production app: https://tasktime.pro
• Agent docs: https://tasktime.pro/agents/
• Public source: https://github.com/tasktimepro/tasktime

Highlights

• Projects, clients, hierarchical tasks, project notes, and weekly planning
• Multiple project timers with pause, stop, and automatic time-entry creation
• Expenses, tax-return periods, recurring expenses, and backup/restore flows
• Save invoice drafts to finish later, continue or explicitly refresh selected work from the Drafts tab, then finalize when ready. The UI and agent share this workflow; drafts leave work unbilled and do not reserve final invoice numbers.
• Terminal cancellation of finalized unpaid invoices, templates, PDF export, payments, quotes, and reports
• Local-first storage with browser persistence and optional provider-backed sync
• Agent-ready local MCP bridge with scopes, approval tokens, and generated tool docs

Quick Start

Requirements:

• Docker with Docker Compose (2.20.3+ for the optional grouped site)
• make

All Node/npm commands run through Docker.

make install
make dev

Open http://localhost:3101.

The optional public site is a separate Git checkout at tasktime-site/, ignored by core just like tasktime-infra/. When present, make dev includes its own Compose service in the tasktime Docker Desktop group at http://localhost:3102. The app stays on port 3101, and app/site links point to each other locally. The group runs detached: Docker Desktop Stop/Play controls all prepared services; make stop also preserves the containers for Play. Use make logs to follow logs. make site-dev / make site-stop control only that grouped site service. For a different site host port, use TASKTIMESITEPORT=3103 make dev; its container still listens on 3102 and the app's site links follow the host override. Core builds and tooling never require either nested repository.

Common Commands

Shortened. The full README is on GitHub.