add_manual_time_entry
Create a manual time entry after TaskTime Pro validates billing cutoffs and overlaps against complete local history.
endrequirednotestartrequiredtaskIdrequiredidempotencyKeybillingIncrementMinutes
pro.tasktimePublished by tasktime.prov1.2.1Updated Nov 3, 2026
First-party local TaskTime Pro tools for tasks, timers, expenses, invoices, reports, and planning.
TaskTime Pro's local MCP server, published by tasktime.pro; no sign-in required; STDIO; 124 tools.
No AI overview yet: these facts come from the registry entry and the server itself.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
@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:
Useful commands:
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.
Source: agent-bridge/README.md at commit 7c07618
Create a manual time entry after TaskTime Pro validates billing cutoffs and overlaps against complete local history.
endrequirednotestartrequiredtaskIdrequiredidempotencyKeybillingIncrementMinutesArchive a business logo brand asset without deleting invoices or business profile references.
businessBrandAssetIdrequiredArchive an existing client without deleting related data.
clientIdrequiredArchive an expense category without deleting expenses or recurring templates that reference it.
expenseCategoryIdrequiredArchive an existing project without deleting related data.
projectIdrequiredArchive a task using TaskTime Pro archive behavior. This is not a destructive delete.
taskIdrequiredAttach a client, project, or task to the planner for a static pin, date, weekday, this week, or every week.
datemoderequiredtyperequiredweekdayreferenceIdrequiredduplicateModeweekStartDateestimatedHoursidempotencyKeyincludeWeekendsDelete a client and either convert linked projects to personal or delete related non-billed project data after preview matching, explicit confirmation, and TaskTime Pro approval. Invoice-linked, billed, or tax-claimed records are rejected.
clientIdrequiredconfirmDeleterequiredexpectedTaskIdsconfirmationTextrequiredexpectedTimerKeysalsoDeleteProjectsexpectedExpenseIdsexpectedTimeEntryIdsexpectedRecurrenceIdsexpectedProjectIdsToDeleteexpectedPlannerAttachmentIdsexpectedProjectIdsToConvertToPersonalDelete a project and related non-billed tasks, active time entries, timers, expenses, recurring templates, and planner attachments after preview matching, explicit confirmation, and TaskTime Pro approval. Invoice-linked, billed, or tax-claimed records are rejected.
projectIdrequiredconfirmDeleterequiredexpectedTaskIdsrequiredconfirmationTextrequiredexpectedTimerKeysexpectedExpenseIdsexpectedTimeEntryIdsrequiredexpectedRecurrenceIdsexpectedPlannerAttachmentIdsDelete a task, descendant tasks, related active time entries, matching timers, and planner attachments after preview matching, explicit confirmation, and TaskTime Pro approval. Billed or invoice-linked tasks are rejected.
taskIdrequiredconfirmDeleterequiredexpectedTaskIdsrequiredconfirmationTextrequiredexpectedTimerKeysexpectedTimeEntryIdsrequiredexpectedPlannerAttachmentIdsDiscard an active timer without creating a time entry after explicit confirmation and TaskTime Pro approval.
taskIdtimerKeyconfirmClearrequiredconfirmationTextrequiredComplete a non-recurring task or a specific recurring occurrence.
taskIdrequiredoccurrenceDateCreate a validated business logo brand asset for an existing business profile, reusing an existing matching content hash when present.
idkindwidthrequiredheightrequireddataUrlrequiredbyteSizerequiredfileNamemimeTyperequiredcontentHashrequiredbusinessInfoIdrequiredidempotencyKeyCreate a business profile for invoice sender/tax details. Requires title/name and businessName/name.
idvatzipcitynameemailphonestatetaxIdtitleaddresscountry+9 moreCreate a non-archived TaskTime Pro client. Free includes one active client; trial and Pro include unlimited active clients.
idvatzipcitycoloremailnotesphonestatetitlerequiredaddresscountry+10 moreCreate an invoice or quote email template with subject, body, reminder body, and attachment filename defaults.
idnamerequiredtyperequiredreplyTosubjectrequiredfromNamesendBodyrequiredisDefaultreminderBodyrequiredidempotencyKeyattachmentTitlerequiredCreate an expense through the TaskTime Pro command layer.
daterequirednotetitlerequiredamountrequiredpaidBypaidOntaxRatebillablerequiredclientIdcurrencyrequiredtaxLabelprojectId+14 moreCreate a non-archived expense category through the validated settings collection.
idnamerequiredcolorgrouparchivedisDefaultidempotencyKeyCreate a recurring expense template and optionally generate the initial expense instance when due, matching the UI flow.
idnotetitlerequiredactiveamountrequiredpaidByrepeatrequiredendDatetaxRatebillablerequiredclientIdcurrencyrequired+16 moreCreate a draft invoice from unbilled project work. This creates only a draft invoice record and does not mark entries or expenses billed, update task billing cutoffs, update project invoice references, or advance invoice numbering.
notesdueDateclientIdprojectIdrequiredtemplateIdinvoiceDateexchangeRatesinvoiceNumberbusinessInfoIdidempotencyKeypaymentMethodIdbillingPeriodEnd+2 moreCreate an invoice template with sequence, tax, notes, and branding defaults.
idnamerequiredprefixisDefaultlayoutStyledefaultNoteslogoPlacementdefaultDueDaysdefaultTaxRateidempotencyKeybrandingOptionsshowProjectTitle+3 moreCreate a payment method. The first method becomes default unless specified otherwise.
idbankibanswifttitlerequiredcustompaypalfullNameisDefaultbankAddressinstructionsidempotencyKeyCreate a non-archived TaskTime Pro project, optionally linked to an existing preferred client.
idcolortitlerequireddeadlineflatRatetaskSorttaskViewhourlyRateisPersonalstatusModedescriptionbudgetAmount+3 moreCreate a TaskTime Pro task or subtask. Subtasks cannot be recurring.
notetitlerequiredbillableprojectIdrecurringstartDateparentTaskIdestimatedHoursidempotencyKeypromptTimeEntryestimatedFlatAmountCreate a tax return period for VAT, income-tax, sales-tax, or other reporting workflows.
idtyperequirednotestitlerequiredpaidAtstatusendDaterequiredfiledAtstartDaterequiredbusinessInfoIdidempotencyKeyDelete one unreferenced business logo brand asset after explicit command confirmation and TaskTime Pro approval. Assets referenced by business profiles or invoice snapshots are rejected.
confirmDeleterequiredconfirmationTextrequiredbusinessBrandAssetIdrequiredDelete one unreferenced business profile after explicit command confirmation and TaskTime Pro approval. Profiles referenced by invoices, brand assets, expenses, recurring templates, or tax return periods are rejected.
confirmDeleterequiredbusinessInfoIdrequiredconfirmationTextrequiredDelete one unreferenced client after explicit command confirmation and TaskTime Pro approval.
clientIdrequiredconfirmDeleterequiredconfirmationTextrequiredDelete one invoice or quote email template after explicit command confirmation and TaskTime Pro approval.
confirmDeleterequiredemailTemplateIdrequiredconfirmationTextrequiredDelete one active unbilled and unclaimed expense after explicit command confirmation and TaskTime Pro approval. Billed and tax-claimed expenses are rejected.
expenseIdrequiredconfirmDeleterequiredconfirmationTextrequiredDelete one unreferenced expense category after explicit command confirmation and TaskTime Pro approval. Categories referenced by expenses or recurring templates are rejected.
confirmDeleterequiredconfirmationTextrequiredexpenseCategoryIdrequiredDelete one recurring expense template after explicit command confirmation and TaskTime Pro approval without deleting generated expenses.
recurrenceIdrequiredconfirmDeleterequiredconfirmationTextrequiredDelete an unissued draft after confirmation. Source time, expenses and numbering remain unchanged.
invoiceIdrequiredconfirmDeleterequiredDelete one unreferenced invoice template after explicit command confirmation and TaskTime Pro approval. Templates referenced by invoices are rejected.
confirmDeleterequiredconfirmationTextrequiredinvoiceTemplateIdrequiredDelete one unreferenced payment method after explicit command confirmation and TaskTime Pro approval. Payment methods referenced by invoices are rejected.
confirmDeleterequiredpaymentMethodIdrequiredconfirmationTextrequiredDelete one unreferenced project after explicit command confirmation and TaskTime Pro approval.
projectIdrequiredconfirmDeleterequiredconfirmationTextrequiredDelete one unreferenced active or archived task after explicit command confirmation and TaskTime Pro approval.
taskIdrequiredconfirmDeleterequiredconfirmationTextrequiredDelete one active unbilled time entry after explicit command confirmation and TaskTime Pro approval. Historical and billed entries are rejected.
entryIdrequiredconfirmDeleterequiredconfirmationTextrequiredFind canonical invoice-eligible time across complete local history, optionally scoped by project or task.
limittaskIdprojectIdFocus the TaskTime Pro app on a running timer by timer key or task ID.
taskIdtimerKeyList active timers with resolved timer keys and elapsed time.
Takes no parameters.
Get a bounded client summary with project, expense, and invoice totals.
clientIdrequiredGet a bounded summary of current work and canonical invoice-eligible time across complete local history.
Takes no parameters.
Return the active local TaskTime Pro bridge endpoint, launch URL, pairing expiry, stable agent identity, and app-session status. This tool works before the browser app is paired.
Takes no parameters.
Return validated TaskTime Pro user preferences. Sync/backup control state is readable but not mutable through update_preferences.
Takes no parameters.
Read project notes in persisted TipTap JSON format plus plain text.
projectIdrequiredGet a bounded project summary with canonical invoice-eligible time across complete local history.
projectIdrequiredGet the Free basic current-month Overview with scope=basic-current-month, or Pro advanced Reports summaries. Omitted scope remains advanced.
scopeperiodsectionclientIdrowLimitcustomEndprojectIdbusinessIdcategoryIdcustomStartincludeRowsexpenseStatus+3 moreRead the active cloud provider, sync status, auto-sync mode, pending changes, and backup preference metadata.
Takes no parameters.
List business logo brand assets, optionally scoped to a business profile and including archived assets or data URLs.
businessInfoIdincludeDataUrlincludeArchivedList business profiles used for invoices, expenses, and tax/reporting context.
Takes no parameters.
List TaskTime Pro clients visible to the paired app session.
includeArchivedList weekday daily planner goals.
weekdayList invoice/quote email templates, optionally filtered by template type.
typeList active expense categories used by expense and recurring expense workflows. Set includeArchived to true to include archived categories.
includeArchivedList recurring expense templates, optionally scoped by client/project or active status.
clientIdprojectIdactiveOnlyList expenses, optionally scoped by client, project, or billable state.
clientIdprojectIdbillableOnlyList invoice templates, including sequence and branding defaults.
Takes no parameters.
List invoices as bounded summary records, optionally scoped by client, project, or status.
limitstatusclientIdprojectIdList payment methods used on invoices and expenses.
Takes no parameters.
List planner attachments, optionally filtered by entity, mode, date, or weekday.
datemodetypeweekdayreferenceIdList active TaskTime Pro projects visible to the paired app session.
Takes no parameters.
List recent entries across complete local history with actual and billable duration summaries.
limittaskIdprojectIdList TaskTime Pro tasks, optionally scoped to a project ID.
projectIdList tax return periods used by Reports tax-claim workflows.
Takes no parameters.
Mark an expense paid using existing TaskTime Pro payment snapshot behavior.
amountpaidBypaidOnexpenseIdrequiredMark an expense unpaid.
expenseIdrequiredMark selected expenses as tax claimed against an existing tax return period after explicit confirmation and TaskTime Pro approval.
expenseIdsrequiredconfirmClaimrequiredtaxReturnPeriodIdrequiredClear tax claim status and period links from selected expenses after explicit confirmation and TaskTime Pro approval.
expenseIdsrequiredconfirmUnclaimrequiredMark a tax return period filed after explicit confirmation and TaskTime Pro approval.
filedAtconfirmFiledrequiredtaxReturnPeriodIdrequiredMark a tax return period paid after explicit confirmation and TaskTime Pro approval.
paidAtfiledAtconfirmPaidrequiredtaxReturnPeriodIdrequiredOpen the TaskTime Pro account route, optionally focused on a specific Account section.
sectionOpen a client view in the paired TaskTime Pro app session after validating the client exists.
clientIdrequiredOpen the TaskTime Pro dashboard route in the paired app session.
Takes no parameters.
Open the expenses route, optionally scoped by client or project.
clientIdprojectIdOpen the invoices route, optionally focused on an existing invoice.
invoiceIdOpen the TaskTime Pro planner route, optionally for a specific year and week.
weekyearOpen a project view in the paired TaskTime Pro app session after validating the project exists.
projectIdrequiredOpen the TaskTime Pro reports route in the paired app session.
Takes no parameters.
Pause a recurring expense template without deleting generated expenses.
recurrenceIdrequiredPause a timer by timer key or task ID.
taskIdpausedAttimerKeyValidate a TaskTime Pro backup JSON payload and return version/count metadata without changing current data.
backupJsonrequiredPreview the UI-style cascade impact of deleting a client without mutating data.
clientIdrequiredalsoDeleteProjectsincludeInvoiceDeletionPreview the UI-style cascade impact of deleting a project without mutating data.
projectIdrequiredincludeInvoiceDeletionPreview the UI-style cascade impact of deleting an active or archived task without mutating data.
taskIdrequiredResolve invoice email recipient, template, subject, body, and attachment filename without sending email or mutating invoice state.
tobodyreplyTosubjectfromNamesendTypeinvoiceIdrequiredtemplateIdforwardToSelfattachmentTitleCalculate a read-only invoice preview from unbilled project work. This does not create invoices, mark billing state, or advance invoice numbering.
projectIdrequiredexchangeRatesbillingPeriodEndbillingPeriodStartincludeClientLevelExpensesBuild a non-persistent quote document from project estimates without creating invoices or billing side effects.
noteclientIdprojectIdrequiredquoteDatequoteTasksbusinessInfoIdquoteTimestampadditionalTaskspaymentMethodIdinvoiceTemplateIdResolve project quote email recipient, template fields, body, and attachment title without sending email or mutating data.
tobodynotereplyTosubjectclientIdfromNameprojectIdrequiredquoteDatequoteTasksforwardToSelfbusinessInfoId+6 moreRebuild and save linked work for the draft client/project scope and billing period after confirmation, including client-only expenses. Reset linked task/expense selections, hours, rates and merged rows. Retain manual items, notes, discount, shipping and tax settings. Review the refreshed draft before finalization.
invoiceIdrequiredexchangeRatesconfirmRefreshrequiredCreate a fresh local TaskTime Pro pairing challenge and launch URL for the same bridge process when the previous pairing code expired or was consumed. This tool works before the browser app is paired.
Takes no parameters.
Remove a weekday daily planner goal.
weekdayrequiredRemove one planner attachment without deleting the referenced entity.
plannerAttachmentIdrequiredResume a paused recurring expense template without changing already-generated expenses.
recurrenceIdrequiredResume a paused timer by timer key or task ID.
taskIdtimerKeyidempotencyKeySet or clear a weekday daily planner goal.
weekdayrequiredtargetHourstargetEarningsSet the default business profile and clear default status from the others.
businessInfoIdrequiredSet the default email template for its type and clear default status from other templates of the same type.
emailTemplateIdrequiredSet the default invoice template and clear default status from the others.
invoiceTemplateIdrequiredSet the default payment method and clear default status from the others.
paymentMethodIdrequiredStart a timer for a task. Existing active timers for the same key are not overwritten.
notetaskIdrequiredidempotencyKeyStop a timer and create one matching time entry with complete-history validation and replay/concurrency recovery.
taskIdtimerKeyidempotencyKeyRestore an archived business logo brand asset without changing invoices or business profile references.
businessBrandAssetIdrequiredRestore an archived client without changing related data. Free includes one active client; trial and Pro include unlimited active clients.
clientIdrequiredRestore an archived expense category without changing related expenses or recurring templates.
expenseCategoryIdrequiredRestore an archived project without changing related data.
projectIdrequiredRestore an archived task using TaskTime Pro unarchive behavior. This is not a destructive recreate.
taskIdrequiredUpdate a business logo brand asset without deleting invoices or business profile references.
updatesrequiredbusinessBrandAssetIdrequiredUpdate a business profile without deleting invoices, expenses, or brand assets.
updatesrequiredbusinessInfoIdrequiredUpdate client fields. Editing is always available; changing archived to false applies the active-client policy.
updatesrequiredclientIdrequiredUpdate an invoice or quote email template.
updatesrequiredemailTemplateIdrequiredUpdate expense category metadata such as name, group, color, default flag, and archive state.
updatesrequiredexpenseCategoryIdrequiredUpdate a recurring expense template for future generated expenses without mutating already-created expenses.
updatesrequiredrecurrenceIdrequiredEdit allowed metadata, line items, totals, and UI composition fields on an existing draft invoice. Set draftNumberMode to automatic or manual; an invoiceNumber edit defaults to manual. This does not mark billing state, update task billing cutoffs, link projects, or advance invoice numbering.
updatesrequiredinvoiceIdrequiredUpdate an invoice template. Sequence changes are allowed but should be deliberate.
updatesrequiredinvoiceTemplateIdrequiredUpdate a payment method without deleting invoices or expenses that reference older snapshots.
updatesrequiredpaymentMethodIdrequiredUpdate planner attachment options such as estimated hours.
estimatedHoursplannerAttachmentIdrequiredUpdate non-sync user preferences such as currency, theme, date/time format, default view, week start, task visibility, default billable behavior, sorting, weekly goals, and notification time. Sync/backup preferences are intentionally rejected.
updatesrequiredUpdate non-destructive project fields such as title, rates, client link, color, deadline, budget, and task view preferences.
updatesrequiredprojectIdrequiredUpdate project notes with plain text or TipTap JSON using the same persisted notes payload as the UI.
clearcontentplainTextprojectIdrequiredUpdate a TaskTime Pro task through relationship and task-state invariants. Use complete_task for recurring occurrences. Set updates.recurring.paused to true to pause the schedule or false to resume without catching up; include the recurrence type and schedule. Timer state is unchanged.
taskIdrequiredupdatesrequiredUpdate non-status tax return period metadata such as title, dates, business profile, and notes. Filing/payment status changes use explicit status tools.
updatesrequiredtaxReturnPeriodIdrequiredEdit an active unbilled time entry after validating source/target task, billing cutoff, and complete-history overlap rules. Historical and billed entries are rejected.
endnotestarttaskIdentryIdrequiredbillingIncrementMinutesUpdate an active timer note and/or start timestamp.
notetaskIdtimerKeystartTime90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
npx @tasktimepro/agent-bridge --app-url https://app.tasktime.protasktime-agent-bridge --manifesttasktime-agent-bridge --app-url https://app.tasktime.pro