add_manual_time_entry
Create a manual time entry after TaskTime Pro validates billing cutoffs and overlaps against complete local history.
end必填notestart必填taskId必填idempotencyKeybillingIncrementMinutes
pro.tasktime由 tasktime.pro 发布v1.2.1更新于 Nov 3, 2026
TaskTime Pro 第一方本地工具,用于任务、计时器、费用、发票、报告和规划。
AI 翻译由 AI 模型根据下方的原文描述翻译,可能有误。
First-party local TaskTime Pro tools for tasks, timers, expenses, invoices, reports, and planning.
TaskTime Pro 的本地 MCP 服务,由 tasktime.pro 发布;无需登录;STDIO;124 个工具。
暂无 AI 概览:以下信息来自注册中心条目和服务本身。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
@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.
来源:agent-bridge/README.md,提交 7c07618
Create a manual time entry after TaskTime Pro validates billing cutoffs and overlaps against complete local history.
end必填notestart必填taskId必填idempotencyKeybillingIncrementMinutesArchive a business logo brand asset without deleting invoices or business profile references.
businessBrandAssetId必填Archive an existing client without deleting related data.
clientId必填Archive an expense category without deleting expenses or recurring templates that reference it.
expenseCategoryId必填Archive an existing project without deleting related data.
projectId必填Archive a task using TaskTime Pro archive behavior. This is not a destructive delete.
taskId必填Attach a client, project, or task to the planner for a static pin, date, weekday, this week, or every week.
datemode必填type必填weekdayreferenceId必填duplicateModeweekStartDateestimatedHoursidempotencyKeyincludeWeekendsDelete 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.
clientId必填confirmDelete必填expectedTaskIdsconfirmationText必填expectedTimerKeysalsoDeleteProjectsexpectedExpenseIdsexpectedTimeEntryIdsexpectedRecurrenceIdsexpectedProjectIdsToDeleteexpectedPlannerAttachmentIdsexpectedProjectIdsToConvertToPersonalDelete 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.
projectId必填confirmDelete必填expectedTaskIds必填confirmationText必填expectedTimerKeysexpectedExpenseIdsexpectedTimeEntryIds必填expectedRecurrenceIdsexpectedPlannerAttachmentIdsDelete 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.
taskId必填confirmDelete必填expectedTaskIds必填confirmationText必填expectedTimerKeysexpectedTimeEntryIds必填expectedPlannerAttachmentIdsDiscard an active timer without creating a time entry after explicit confirmation and TaskTime Pro approval.
taskIdtimerKeyconfirmClear必填confirmationText必填Complete a non-recurring task or a specific recurring occurrence.
taskId必填occurrenceDateCreate a validated business logo brand asset for an existing business profile, reusing an existing matching content hash when present.
idkindwidth必填height必填dataUrl必填byteSize必填fileNamemimeType必填contentHash必填businessInfoId必填idempotencyKeyCreate a business profile for invoice sender/tax details. Requires title/name and businessName/name.
idvatzipcitynameemailphonestatetaxIdtitleaddresscountry另有 9 个Create a non-archived TaskTime Pro client. Free includes one active client; trial and Pro include unlimited active clients.
idvatzipcitycoloremailnotesphonestatetitle必填addresscountry另有 10 个Create an invoice or quote email template with subject, body, reminder body, and attachment filename defaults.
idname必填type必填replyTosubject必填fromNamesendBody必填isDefaultreminderBody必填idempotencyKeyattachmentTitle必填Create an expense through the TaskTime Pro command layer.
date必填notetitle必填amount必填paidBypaidOntaxRatebillable必填clientIdcurrency必填taxLabelprojectId另有 14 个Create a non-archived expense category through the validated settings collection.
idname必填colorgrouparchivedisDefaultidempotencyKeyCreate a recurring expense template and optionally generate the initial expense instance when due, matching the UI flow.
idnotetitle必填activeamount必填paidByrepeat必填endDatetaxRatebillable必填clientIdcurrency必填另有 16 个Create 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.
notesdueDateclientIdprojectId必填templateIdinvoiceDateexchangeRatesinvoiceNumberbusinessInfoIdidempotencyKeypaymentMethodIdbillingPeriodEnd另有 2 个Create an invoice template with sequence, tax, notes, and branding defaults.
idname必填prefixisDefaultlayoutStyledefaultNoteslogoPlacementdefaultDueDaysdefaultTaxRateidempotencyKeybrandingOptionsshowProjectTitle另有 3 个Create a payment method. The first method becomes default unless specified otherwise.
idbankibanswifttitle必填custompaypalfullNameisDefaultbankAddressinstructionsidempotencyKeyCreate a non-archived TaskTime Pro project, optionally linked to an existing preferred client.
idcolortitle必填deadlineflatRatetaskSorttaskViewhourlyRateisPersonalstatusModedescriptionbudgetAmount另有 3 个Create a TaskTime Pro task or subtask. Subtasks cannot be recurring.
notetitle必填billableprojectIdrecurringstartDateparentTaskIdestimatedHoursidempotencyKeypromptTimeEntryestimatedFlatAmountCreate a tax return period for VAT, income-tax, sales-tax, or other reporting workflows.
idtype必填notestitle必填paidAtstatusendDate必填filedAtstartDate必填businessInfoIdidempotencyKeyDelete one unreferenced business logo brand asset after explicit command confirmation and TaskTime Pro approval. Assets referenced by business profiles or invoice snapshots are rejected.
confirmDelete必填confirmationText必填businessBrandAssetId必填Delete 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.
confirmDelete必填businessInfoId必填confirmationText必填Delete one unreferenced client after explicit command confirmation and TaskTime Pro approval.
clientId必填confirmDelete必填confirmationText必填Delete one invoice or quote email template after explicit command confirmation and TaskTime Pro approval.
confirmDelete必填emailTemplateId必填confirmationText必填Delete one active unbilled and unclaimed expense after explicit command confirmation and TaskTime Pro approval. Billed and tax-claimed expenses are rejected.
expenseId必填confirmDelete必填confirmationText必填Delete one unreferenced expense category after explicit command confirmation and TaskTime Pro approval. Categories referenced by expenses or recurring templates are rejected.
confirmDelete必填confirmationText必填expenseCategoryId必填Delete one recurring expense template after explicit command confirmation and TaskTime Pro approval without deleting generated expenses.
recurrenceId必填confirmDelete必填confirmationText必填Delete an unissued draft after confirmation. Source time, expenses and numbering remain unchanged.
invoiceId必填confirmDelete必填Delete one unreferenced invoice template after explicit command confirmation and TaskTime Pro approval. Templates referenced by invoices are rejected.
confirmDelete必填confirmationText必填invoiceTemplateId必填Delete one unreferenced payment method after explicit command confirmation and TaskTime Pro approval. Payment methods referenced by invoices are rejected.
confirmDelete必填paymentMethodId必填confirmationText必填Delete one unreferenced project after explicit command confirmation and TaskTime Pro approval.
projectId必填confirmDelete必填confirmationText必填Delete one unreferenced active or archived task after explicit command confirmation and TaskTime Pro approval.
taskId必填confirmDelete必填confirmationText必填Delete one active unbilled time entry after explicit command confirmation and TaskTime Pro approval. Historical and billed entries are rejected.
entryId必填confirmDelete必填confirmationText必填Find 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.
无需输入参数。
Get a bounded client summary with project, expense, and invoice totals.
clientId必填Get a bounded summary of current work and canonical invoice-eligible time across complete local history.
无需输入参数。
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.
无需输入参数。
Return validated TaskTime Pro user preferences. Sync/backup control state is readable but not mutable through update_preferences.
无需输入参数。
Read project notes in persisted TipTap JSON format plus plain text.
projectId必填Get a bounded project summary with canonical invoice-eligible time across complete local history.
projectId必填Get the Free basic current-month Overview with scope=basic-current-month, or Pro advanced Reports summaries. Omitted scope remains advanced.
scopeperiodsectionclientIdrowLimitcustomEndprojectIdbusinessIdcategoryIdcustomStartincludeRowsexpenseStatus另有 3 个Read the active cloud provider, sync status, auto-sync mode, pending changes, and backup preference metadata.
无需输入参数。
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.
无需输入参数。
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.
无需输入参数。
List invoices as bounded summary records, optionally scoped by client, project, or status.
limitstatusclientIdprojectIdList payment methods used on invoices and expenses.
无需输入参数。
List planner attachments, optionally filtered by entity, mode, date, or weekday.
datemodetypeweekdayreferenceIdList active TaskTime Pro projects visible to the paired app session.
无需输入参数。
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.
无需输入参数。
Mark an expense paid using existing TaskTime Pro payment snapshot behavior.
amountpaidBypaidOnexpenseId必填Mark an expense unpaid.
expenseId必填Mark selected expenses as tax claimed against an existing tax return period after explicit confirmation and TaskTime Pro approval.
expenseIds必填confirmClaim必填taxReturnPeriodId必填Clear tax claim status and period links from selected expenses after explicit confirmation and TaskTime Pro approval.
expenseIds必填confirmUnclaim必填Mark a tax return period filed after explicit confirmation and TaskTime Pro approval.
filedAtconfirmFiled必填taxReturnPeriodId必填Mark a tax return period paid after explicit confirmation and TaskTime Pro approval.
paidAtfiledAtconfirmPaid必填taxReturnPeriodId必填Open 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.
clientId必填Open the TaskTime Pro dashboard route in the paired app session.
无需输入参数。
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.
projectId必填Open the TaskTime Pro reports route in the paired app session.
无需输入参数。
Pause a recurring expense template without deleting generated expenses.
recurrenceId必填Pause a timer by timer key or task ID.
taskIdpausedAttimerKeyValidate a TaskTime Pro backup JSON payload and return version/count metadata without changing current data.
backupJson必填Preview the UI-style cascade impact of deleting a client without mutating data.
clientId必填alsoDeleteProjectsincludeInvoiceDeletionPreview the UI-style cascade impact of deleting a project without mutating data.
projectId必填includeInvoiceDeletionPreview the UI-style cascade impact of deleting an active or archived task without mutating data.
taskId必填Resolve invoice email recipient, template, subject, body, and attachment filename without sending email or mutating invoice state.
tobodyreplyTosubjectfromNamesendTypeinvoiceId必填templateIdforwardToSelfattachmentTitleCalculate a read-only invoice preview from unbilled project work. This does not create invoices, mark billing state, or advance invoice numbering.
projectId必填exchangeRatesbillingPeriodEndbillingPeriodStartincludeClientLevelExpensesBuild a non-persistent quote document from project estimates without creating invoices or billing side effects.
noteclientIdprojectId必填quoteDatequoteTasksbusinessInfoIdquoteTimestampadditionalTaskspaymentMethodIdinvoiceTemplateIdResolve project quote email recipient, template fields, body, and attachment title without sending email or mutating data.
tobodynotereplyTosubjectclientIdfromNameprojectId必填quoteDatequoteTasksforwardToSelfbusinessInfoId另有 6 个Rebuild 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.
invoiceId必填exchangeRatesconfirmRefresh必填Create 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.
无需输入参数。
Remove a weekday daily planner goal.
weekday必填Remove one planner attachment without deleting the referenced entity.
plannerAttachmentId必填Resume a paused recurring expense template without changing already-generated expenses.
recurrenceId必填Resume a paused timer by timer key or task ID.
taskIdtimerKeyidempotencyKeySet or clear a weekday daily planner goal.
weekday必填targetHourstargetEarningsSet the default business profile and clear default status from the others.
businessInfoId必填Set the default email template for its type and clear default status from other templates of the same type.
emailTemplateId必填Set the default invoice template and clear default status from the others.
invoiceTemplateId必填Set the default payment method and clear default status from the others.
paymentMethodId必填Start a timer for a task. Existing active timers for the same key are not overwritten.
notetaskId必填idempotencyKeyStop 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.
businessBrandAssetId必填Restore an archived client without changing related data. Free includes one active client; trial and Pro include unlimited active clients.
clientId必填Restore an archived expense category without changing related expenses or recurring templates.
expenseCategoryId必填Restore an archived project without changing related data.
projectId必填Restore an archived task using TaskTime Pro unarchive behavior. This is not a destructive recreate.
taskId必填Update a business logo brand asset without deleting invoices or business profile references.
updates必填businessBrandAssetId必填Update a business profile without deleting invoices, expenses, or brand assets.
updates必填businessInfoId必填Update client fields. Editing is always available; changing archived to false applies the active-client policy.
updates必填clientId必填Update an invoice or quote email template.
updates必填emailTemplateId必填Update expense category metadata such as name, group, color, default flag, and archive state.
updates必填expenseCategoryId必填Update a recurring expense template for future generated expenses without mutating already-created expenses.
updates必填recurrenceId必填Edit 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.
updates必填invoiceId必填Update an invoice template. Sequence changes are allowed but should be deliberate.
updates必填invoiceTemplateId必填Update a payment method without deleting invoices or expenses that reference older snapshots.
updates必填paymentMethodId必填Update planner attachment options such as estimated hours.
estimatedHoursplannerAttachmentId必填Update 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.
updates必填Update non-destructive project fields such as title, rates, client link, color, deadline, budget, and task view preferences.
updates必填projectId必填Update project notes with plain text or TipTap JSON using the same persisted notes payload as the UI.
clearcontentplainTextprojectId必填Update 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.
taskId必填updates必填Update non-status tax return period metadata such as title, dates, business profile, and notes. Filing/payment status changes use explicit status tools.
updates必填taxReturnPeriodId必填Edit an active unbilled time entry after validating source/target task, billing cutoff, and complete-history overlap rules. Historical and billed entries are rejected.
endnotestarttaskIdentryId必填billingIncrementMinutesUpdate an active timer note and/or start timestamp.
notetaskIdtimerKeystartTime已满足适用检查项的 90%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
npx @tasktimepro/agent-bridge --app-url https://app.tasktime.protasktime-agent-bridge --manifesttasktime-agent-bridge --app-url https://app.tasktime.pro