TaskTime Pro Agent Bridge
@tasktimepro/agent-bridge provides the tasktime-agent-bridge binary used by same-device AI agents to talk to TaskTime Pro over MCP stdio.
TaskTime Pro is a free, open-source, local-first work manager for freelancers. 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.
The bridge does not read or write TaskTime Pro IndexedDB/Yjs data directly. It starts a loopback app-session endpoint, waits for the running TaskTime Pro browser app to pair through Account > Agent Access, and forwards MCP tool calls to the paired browser app.
Billing-scoped tools include approval-gated invoice finalization and cancellation. Cancellation is limited to finalized unpaid invoices, retains the invoice number and audit record, and releases only source work owned by that invoice.
The paired app also owns subscription policy. Free supports one active client and the closed get_report_summary({"scope":"basic-current-month"}) overview. Advanced Reports and report exports require Pro. Email preparation and PDF export remain Free, while TaskTime-hosted invoice/quote sending requires Pro and explicit confirmation. Use get_email_send_status to reconcile an ambiguous attempt without resending it.
Install and run:
npx @tasktimepro/agent-bridge --app-url https://app.tasktime.pro
Useful commands:
tasktime-agent-bridge --manifest
tasktime-agent-bridge --app-url https://app.tasktime.pro
Use --status-file only for non-secret process/endpoint discovery. Pairing IDs, pairing codes, and launch URLs remain available through interactive stderr and the get_pairing_status/refresh_pairing setup tools; the persisted status file intentionally excludes them and is removed on clean shutdown.
The current browser tab can resume a bounded app session across refresh from sessionStorage. Same-profile close/reopen continuity uses a non-exportable browser signing key and a single-use bridge challenge to obtain a fresh session. No reusable bearer token is stored durably. Explicit disconnect/revoke/disable, expiry, or bridge restart requires pairing again.
Official MCP Registry name: pro.tasktime/agent-bridge.
Public docs:
License: AGPL-3.0-only.