TaskTime Pro local agent bridge

TaskTime Pro MCP Tools

Generated reference for TaskTime Pro local agent bridge MCP tools, scopes, input schemas, approval-gated commands, and workflow groups.

Generated Tool Catalog

This reference is generated from the same bridge source used by tasktime-agent-bridge. Agent hosts should still call tools/list at runtime because granted scopes determine the exact tool set available to the current local session.

Machine-readable version: /agents/mcp-tools.json.

The Approval gated badge means the command requires TaskTime Pro approval before mutation. A trusted local approval token can satisfy that gate for the exact command input; otherwise the paired browser app shows a visible approval prompt and remains the final verifier.

Scope Coverage

billing 5 tools email 3 tools export 17 tools navigation 9 tools read 62 tools write 91 tools

Projects and Tasks

Create, update, archive, delete, and inspect projects, clients, tasks, and task relationships.

`archive_client`

Archive an existing client without deleting related data.

Scopes: write
Input fields: clientId

`archive_project`

Archive an existing project without deleting related data.

Scopes: write
Input fields: projectId

`archive_task`

Archive a task using TaskTime Pro archive behavior. This is not a destructive delete.

Scopes: write
Input fields: taskId

`cascade_delete_client`

Approval gated

Delete 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.

Scopes: write
Input fields: clientId, alsoDeleteProjects, confirmDelete, confirmationText, expectedProjectIdsToDelete, expectedProjectIdsToConvertToPersonal, expectedTaskIds, expectedTimeEntryIds, expectedTimerKeys, expectedExpenseIds, expectedRecurrenceIds, expectedPlannerAttachmentIds
Approval: Valid exact-input approval token or visible prompt

`cascade_delete_project`

Approval gated

Delete 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.

Scopes: write
Input fields: projectId, confirmDelete, confirmationText, expectedTaskIds, expectedTimeEntryIds, expectedTimerKeys, expectedExpenseIds, expectedRecurrenceIds, expectedPlannerAttachmentIds
Approval: Valid exact-input approval token or visible prompt

`cascade_delete_task`

Approval gated

Delete 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.

Scopes: write
Input fields: taskId, confirmDelete, confirmationText, expectedTaskIds, expectedTimeEntryIds, expectedTimerKeys, expectedPlannerAttachmentIds
Approval: Valid exact-input approval token or visible prompt

`complete_task`

Complete a non-recurring task or a specific recurring occurrence.

Scopes: write
Input fields: taskId, occurrenceDate

`create_client`

Create a non-archived TaskTime Pro client. Free includes one active client; trial and Pro include unlimited active clients.

Scopes: write
Input fields: id, title, clientName, contactPerson, email, phone, address, city, state, zip, country, registrationNumber, vat, taxNumber, notes, disableTax, defaultHourlyRate, hourlyRate, flatRate, defaultCurrency, color, idempotencyKey

`create_project`

Create a non-archived TaskTime Pro project, optionally linked to an existing preferred client.

Scopes: write
Input fields: id, title, description, hourlyRate, flatRate, preferredClientId, isPersonal, color, billableTimeIncrementMinutes, taskView, taskSort, statusMode, deadline, budgetAmount, idempotencyKey

`create_task`

Create a TaskTime Pro task or subtask. Subtasks cannot be recurring.

Scopes: write
Input fields: title, projectId, parentTaskId, note, billable, startDate, recurring, promptTimeEntry, estimatedHours, estimatedFlatAmount, idempotencyKey

`delete_client`

Approval gated

Delete one unreferenced client after explicit command confirmation and TaskTime Pro approval.

Scopes: write
Input fields: clientId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`delete_project`

Approval gated

Delete one unreferenced project after explicit command confirmation and TaskTime Pro approval.

Scopes: write
Input fields: projectId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`delete_task`

Approval gated

Delete one unreferenced active or archived task after explicit command confirmation and TaskTime Pro approval.

Scopes: write
Input fields: taskId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`get_client_overview`

Get a bounded client summary with project, expense, and invoice totals.

Scopes: read
Input fields: clientId

`get_project_overview`

Get a bounded project summary with canonical invoice-eligible time across complete local history.

Scopes: read
Input fields: projectId

`list_clients`

List TaskTime Pro clients visible to the paired app session.

Scopes: read
Input fields: includeArchived

`list_projects`

List active TaskTime Pro projects visible to the paired app session.

Scopes: read
Input fields: No input fields

`list_tasks`

List TaskTime Pro tasks, optionally scoped to a project ID.

Scopes: read
Input fields: projectId

`preview_delete_client`

Preview the UI-style cascade impact of deleting a client without mutating data.

Scopes: read
Input fields: clientId, alsoDeleteProjects, includeInvoiceDeletion

`preview_delete_project`

Preview the UI-style cascade impact of deleting a project without mutating data.

Scopes: read
Input fields: projectId, includeInvoiceDeletion

`preview_delete_task`

Preview the UI-style cascade impact of deleting an active or archived task without mutating data.

Scopes: read
Input fields: taskId

`unarchive_client`

Restore an archived client without changing related data. Free includes one active client; trial and Pro include unlimited active clients.

Scopes: write
Input fields: clientId

`unarchive_project`

Restore an archived project without changing related data.

Scopes: write
Input fields: projectId

`unarchive_task`

Restore an archived task using TaskTime Pro unarchive behavior. This is not a destructive recreate.

Scopes: write
Input fields: taskId

`update_client`

Update client fields. Editing is always available; changing archived to false applies the active-client policy.

Scopes: write
Input fields: clientId, updates

`update_project`

Update non-destructive project fields such as title, rates, client link, color, deadline, budget, and task view preferences.

Scopes: write
Input fields: projectId, updates

`update_task`

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.

Scopes: write
Input fields: taskId, updates

Timers and Time Entries

Start, pause, resume, stop, clear, and edit timer and time-entry records.

`add_manual_time_entry`

Create a manual time entry after TaskTime Pro validates billing cutoffs and overlaps against complete local history.

Scopes: write
Input fields: taskId, start, end, note, billingIncrementMinutes, idempotencyKey

`clear_timer`

Approval gated

Discard an active timer without creating a time entry after explicit confirmation and TaskTime Pro approval.

Scopes: write
Input fields: timerKey, taskId, confirmClear, confirmationText
Approval: Valid exact-input approval token or visible prompt

`delete_time_entry`

Approval gated

Delete one active unbilled time entry after explicit command confirmation and TaskTime Pro approval. Historical and billed entries are rejected.

Scopes: write
Input fields: entryId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`get_active_timers`

List active timers with resolved timer keys and elapsed time.

Scopes: read
Input fields: No input fields

`pause_timer`

Pause a timer by timer key or task ID.

Scopes: write
Input fields: timerKey, taskId, pausedAt

`resume_timer`

Resume a paused timer by timer key or task ID.

Scopes: write
Input fields: timerKey, taskId, idempotencyKey

`start_timer`

Start a timer for a task. Existing active timers for the same key are not overwritten.

Scopes: write
Input fields: taskId, note, idempotencyKey

`stop_timer`

Stop a timer and create one matching time entry with complete-history validation and replay/concurrency recovery.

Scopes: write
Input fields: timerKey, taskId, idempotencyKey

`update_time_entry`

Edit an active unbilled time entry after validating source/target task, billing cutoff, and complete-history overlap rules. Historical and billed entries are rejected.

Scopes: write
Input fields: entryId, taskId, start, end, note, billingIncrementMinutes

`update_timer`

Update an active timer note and/or start timestamp.

Scopes: write
Input fields: timerKey, taskId, startTime, note

Planner and Notes

Manage planner attachments, daily goals, and project notes.

`attach_planner_item`

Attach a client, project, or task to the planner for a static pin, date, weekday, this week, or every week.

Scopes: write
Input fields: type, referenceId, mode, date, weekday, weekStartDate, includeWeekends, estimatedHours, duplicateMode, idempotencyKey

`get_project_notes`

Read project notes in persisted TipTap JSON format plus plain text.

Scopes: read
Input fields: projectId

`list_daily_goals`

List weekday daily planner goals.

Scopes: read
Input fields: weekday

`list_planner_attachments`

List planner attachments, optionally filtered by entity, mode, date, or weekday.

Scopes: read
Input fields: type, referenceId, mode, date, weekday

`remove_daily_goal`

Remove a weekday daily planner goal.

Scopes: write
Input fields: weekday

`remove_planner_attachment`

Remove one planner attachment without deleting the referenced entity.

Scopes: write
Input fields: plannerAttachmentId

`set_daily_goal`

Set or clear a weekday daily planner goal.

Scopes: write
Input fields: weekday, targetHours, targetEarnings

`update_planner_attachment`

Update planner attachment options such as estimated hours.

Scopes: write
Input fields: plannerAttachmentId, estimatedHours

`update_project_notes`

Update project notes with plain text or TipTap JSON using the same persisted notes payload as the UI.

Scopes: write
Input fields: projectId, plainText, content, clear

Expenses and Tax

Manage expenses, recurring expenses, tax return periods, and tax-claim status.

`archive_expense_category`

Archive an expense category without deleting expenses or recurring templates that reference it.

Scopes: write
Input fields: expenseCategoryId

`create_expense`

Create an expense through the TaskTime Pro command layer.

Scopes: write
Input fields: title, date, amount, currency, isPersonal, billable, note, supplierName, receiptNumber, paidOn, paidBy, paymentStatus, paymentMode, clientId, projectId, businessId, categoryId, isRecurring, recurrenceId, amountType, taxNumber, isTaxExempt, amountExcludingTax, taxLabel, taxRate, idempotencyKey

`create_expense_category`

Create a non-archived expense category through the validated settings collection.

Scopes: write
Input fields: id, name, group, color, isDefault, archived, idempotencyKey

`create_expense_recurrence`

Create a recurring expense template and optionally generate the initial expense instance when due, matching the UI flow.

Scopes: write
Input fields: id, title, note, supplierName, paidBy, paymentMode, currency, amount, amountType, repeat, monthlyType, monthlyDay, startDate, endDate, clientId, projectId, businessId, categoryId, isPersonal, billable, taxNumber, isTaxExempt, amountExcludingTax, taxLabel, taxRate, active, generateInitial, idempotencyKey

`create_tax_return_period`

Create a tax return period for VAT, income-tax, sales-tax, or other reporting workflows.

Scopes: write
Input fields: id, title, type, startDate, endDate, businessInfoId, status, filedAt, paidAt, notes, idempotencyKey

`delete_expense`

Approval gated

Delete one active unbilled and unclaimed expense after explicit command confirmation and TaskTime Pro approval. Billed and tax-claimed expenses are rejected.

Scopes: write
Input fields: expenseId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`delete_expense_category`

Approval gated

Delete one unreferenced expense category after explicit command confirmation and TaskTime Pro approval. Categories referenced by expenses or recurring templates are rejected.

Scopes: write
Input fields: expenseCategoryId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`delete_expense_recurrence`

Approval gated

Delete one recurring expense template after explicit command confirmation and TaskTime Pro approval without deleting generated expenses.

Scopes: write
Input fields: recurrenceId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`list_expense_categories`

List active expense categories used by expense and recurring expense workflows. Set includeArchived to true to include archived categories.

Scopes: read
Input fields: includeArchived

`list_expense_recurrences`

List recurring expense templates, optionally scoped by client/project or active status.

Scopes: read
Input fields: activeOnly, clientId, projectId

`list_expenses`

List expenses, optionally scoped by client, project, or billable state.

Scopes: read
Input fields: clientId, projectId, billableOnly

`list_tax_return_periods`

List tax return periods used by Reports tax-claim workflows.

Scopes: read
Input fields: No input fields

`mark_expense_paid`

Mark an expense paid using existing TaskTime Pro payment snapshot behavior.

Scopes: write
Input fields: expenseId, amount, paidOn, paidBy

`mark_expense_unpaid`

Mark an expense unpaid.

Scopes: write
Input fields: expenseId

`mark_expenses_tax_claimed`

Approval gated

Mark selected expenses as tax claimed against an existing tax return period after explicit confirmation and TaskTime Pro approval.

Scopes: write
Input fields: expenseIds, taxReturnPeriodId, confirmClaim
Approval: Valid exact-input approval token or visible prompt

`mark_expenses_tax_unclaimed`

Approval gated

Clear tax claim status and period links from selected expenses after explicit confirmation and TaskTime Pro approval.

Scopes: write
Input fields: expenseIds, confirmUnclaim
Approval: Valid exact-input approval token or visible prompt

`mark_tax_return_period_filed`

Approval gated

Mark a tax return period filed after explicit confirmation and TaskTime Pro approval.

Scopes: write
Input fields: taxReturnPeriodId, filedAt, confirmFiled
Approval: Valid exact-input approval token or visible prompt

`mark_tax_return_period_paid`

Approval gated

Mark a tax return period paid after explicit confirmation and TaskTime Pro approval.

Scopes: write
Input fields: taxReturnPeriodId, filedAt, paidAt, confirmPaid
Approval: Valid exact-input approval token or visible prompt

`pause_expense_recurrence`

Pause a recurring expense template without deleting generated expenses.

Scopes: write
Input fields: recurrenceId

`resume_expense_recurrence`

Resume a paused recurring expense template without changing already-generated expenses.

Scopes: write
Input fields: recurrenceId

`unarchive_expense_category`

Restore an archived expense category without changing related expenses or recurring templates.

Scopes: write
Input fields: expenseCategoryId

`update_expense_category`

Update expense category metadata such as name, group, color, default flag, and archive state.

Scopes: write
Input fields: expenseCategoryId, updates

`update_expense_recurrence`

Update a recurring expense template for future generated expenses without mutating already-created expenses.

Scopes: write
Input fields: recurrenceId, updates

`update_tax_return_period`

Update non-status tax return period metadata such as title, dates, business profile, and notes. Filing/payment status changes use explicit status tools.

Scopes: write
Input fields: taxReturnPeriodId, updates

Invoices and Quotes

Preview, draft, finalize, cancel, email, export, and update invoices and project quotes.

`cancel_invoice`

Approval gated

Cancel a finalized unpaid invoice after explicit confirmation and exact invoice-number confirmation text. The invoice and number remain as an audit record while source claims owned by that invoice are released for future billing.

Scopes: readwritebilling
Input fields: invoiceId, reason, confirmCancel, confirmationText, canceledAt, idempotencyKey
Approval: Valid exact-input approval token or visible prompt

`create_invoice_draft`

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.

Scopes: readwrite
Input fields: projectId, clientId, invoiceNumber, invoiceDate, dueDate, templateId, businessInfoId, paymentMethodId, notes, billingPeriodStart, billingPeriodEnd, includeClientLevelExpenses, exchangeRates, idempotencyKey

`create_invoice_template`

Create an invoice template with sequence, tax, notes, and branding defaults.

Scopes: write
Input fields: id, name, prefix, useSequentialNumbers, currentSequentialNumber, defaultNotes, defaultTaxRate, defaultDueDays, isDefault, brandingOptions, layoutStyle, logoPlacement, showBillingPeriod, showProjectTitle, idempotencyKey

`delete_invoice_draft`

Approval gated

Delete an unissued draft after confirmation. Source time, expenses and numbering remain unchanged.

Scopes: readwrite
Input fields: invoiceId, confirmDelete
Approval: Valid exact-input approval token or visible prompt

`delete_invoice_template`

Approval gated

Delete one unreferenced invoice template after explicit command confirmation and TaskTime Pro approval. Templates referenced by invoices are rejected.

Scopes: write
Input fields: invoiceTemplateId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`export_invoice_pdf`

Generate and download an invoice PDF in the paired browser app session. The bridge returns status metadata only, not PDF bytes.

Scopes: readexport
Input fields: invoiceId, filename

`export_project_quote_pdf`

Generate and download a non-persistent project quote PDF in the paired browser app session. The bridge returns status metadata only, not PDF bytes.

Scopes: readexport
Input fields: projectId, clientId, businessInfoId, paymentMethodId, invoiceTemplateId, note, quoteDate, quoteTimestamp, quoteTasks, additionalTasks, filename

`finalize_invoice`

Approval gated

Finalize a UI- or agent-created draft invoice after explicit confirmation. This revalidates the saved source selection and marks its time entries and expenses billed, updates task billing cutoffs, links the invoice to the project, advances invoice sequence state, and changes the invoice from draft to sent.

Scopes: readwritebilling
Input fields: invoiceId, confirmFinalize, finalizedAt, idempotencyKey
Approval: Valid exact-input approval token or visible prompt

`list_invoice_templates`

List invoice templates, including sequence and branding defaults.

Scopes: read
Input fields: No input fields

`list_invoices`

List invoices as bounded summary records, optionally scoped by client, project, or status.

Scopes: read
Input fields: clientId, projectId, status, limit

`mark_invoice_paid`

Approval gated

Mark an invoice paid after explicit confirmation. Cross-currency invoices require exchange rates so TaskTime Pro can store the existing payment currency snapshot.

Scopes: readwritebilling
Input fields: invoiceId, confirmPaid, paidAt, exchangeRates, idempotencyKey
Approval: Valid exact-input approval token or visible prompt

`mark_invoice_unpaid`

Approval gated

Mark an invoice unpaid after explicit confirmation, matching TaskTime Pro UI status fallback behavior.

Scopes: readwritebilling
Input fields: invoiceId, confirmUnpaid, referenceAt, idempotencyKey
Approval: Valid exact-input approval token or visible prompt

`preview_invoice_email`

Resolve invoice email recipient, template, subject, body, and attachment filename without sending email or mutating invoice state.

Scopes: read
Input fields: invoiceId, sendType, templateId, to, fromName, replyTo, subject, body, attachmentTitle, forwardToSelf

`preview_invoice_from_unbilled_work`

Calculate a read-only invoice preview from unbilled project work. This does not create invoices, mark billing state, or advance invoice numbering.

Scopes: read
Input fields: projectId, billingPeriodStart, billingPeriodEnd, includeClientLevelExpenses, exchangeRates

`preview_project_quote`

Build a non-persistent quote document from project estimates without creating invoices or billing side effects.

Scopes: read
Input fields: projectId, clientId, businessInfoId, paymentMethodId, invoiceTemplateId, note, quoteDate, quoteTimestamp, quoteTasks, additionalTasks

`preview_project_quote_email`

Resolve project quote email recipient, template fields, body, and attachment title without sending email or mutating data.

Scopes: read
Input fields: projectId, clientId, businessInfoId, paymentMethodId, invoiceTemplateId, note, quoteDate, quoteTimestamp, quoteTasks, additionalTasks, emailTemplateId, to, fromName, replyTo, subject, body, attachmentTitle, forwardToSelf

`refresh_invoice_draft`

Approval gated

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.

Scopes: readwrite
Input fields: invoiceId, confirmRefresh, exchangeRates
Approval: Valid exact-input approval token or visible prompt

`send_invoice_email`

Approval gated

Hosted invoice, reminder, or quote Send requires a Pro trial or subscription, explicit confirmation, and TaskTime Pro approval. Preview and PDF export remain available without hosted Send.

Scopes: readwriteemail
Input fields: invoiceId, sendType, templateId, to, fromName, replyTo, subject, body, attachmentTitle, forwardToSelf, confirmSend, idempotencyKey
Approval: Valid exact-input approval token or visible prompt

`send_project_quote_email`

Approval gated

Hosted quote Send requires a Pro trial or subscription, explicit confirmation, and TaskTime Pro approval. Preview and PDF export remain available without hosted Send.

Scopes: reademail
Input fields: projectId, clientId, businessInfoId, paymentMethodId, invoiceTemplateId, note, quoteDate, quoteTimestamp, quoteTasks, additionalTasks, emailTemplateId, to, fromName, replyTo, subject, body, attachmentTitle, forwardToSelf, confirmSend, idempotencyKey
Approval: Valid exact-input approval token or visible prompt

`set_default_invoice_template`

Set the default invoice template and clear default status from the others.

Scopes: write
Input fields: invoiceTemplateId

`undo_latest_invoice`

Approval gated

Undo the latest unpaid invoice after explicit confirmation text matching the invoice number. Restores billed time entries, invoice adjustments, quoted flat amounts, linked expenses, project invoice references, task cutoffs, and sequence state when safe.

Scopes: readwritebilling
Input fields: invoiceId, confirmUndo, confirmationText, undoneAt, idempotencyKey
Approval: Valid exact-input approval token or visible prompt

`update_invoice_draft`

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.

Scopes: readwrite
Input fields: invoiceId, updates

`update_invoice_template`

Update an invoice template. Sequence changes are allowed but should be deliberate.

Scopes: write
Input fields: invoiceTemplateId, updates

Settings and Templates

Manage preferences, business profiles, payment methods, brand assets, and templates.

`archive_business_brand_asset`

Archive a business logo brand asset without deleting invoices or business profile references.

Scopes: write
Input fields: businessBrandAssetId

`create_business_brand_asset`

Create a validated business logo brand asset for an existing business profile, reusing an existing matching content hash when present.

Scopes: write
Input fields: id, businessInfoId, kind, dataUrl, mimeType, fileName, width, height, byteSize, contentHash, idempotencyKey

`create_business_info`

Create a business profile for invoice sender/tax details. Requires title/name and businessName/name.

Scopes: write
Input fields: id, title, name, businessName, email, phone, address, city, state, zip, country, registrationNumber, vat, taxNumber, taxId, isDefault, taxEnabled, taxLabel, taxRate, branding, idempotencyKey

`create_email_template`

Create an invoice or quote email template with subject, body, reminder body, and attachment filename defaults.

Scopes: write
Input fields: id, name, type, fromName, replyTo, subject, sendBody, reminderBody, attachmentTitle, isDefault, idempotencyKey

`create_payment_method`

Create a payment method. The first method becomes default unless specified otherwise.

Scopes: write
Input fields: id, title, fullName, bank, iban, swift, bankAddress, paypal, instructions, custom, isDefault, idempotencyKey

`delete_business_brand_asset`

Approval gated

Delete one unreferenced business logo brand asset after explicit command confirmation and TaskTime Pro approval. Assets referenced by business profiles or invoice snapshots are rejected.

Scopes: write
Input fields: businessBrandAssetId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`delete_business_info`

Approval gated

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.

Scopes: write
Input fields: businessInfoId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`delete_email_template`

Approval gated

Delete one invoice or quote email template after explicit command confirmation and TaskTime Pro approval.

Scopes: write
Input fields: emailTemplateId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`delete_payment_method`

Approval gated

Delete one unreferenced payment method after explicit command confirmation and TaskTime Pro approval. Payment methods referenced by invoices are rejected.

Scopes: write
Input fields: paymentMethodId, confirmDelete, confirmationText
Approval: Valid exact-input approval token or visible prompt

`get_preferences`

Return validated TaskTime Pro user preferences. Sync/backup control state is readable but not mutable through update_preferences.

Scopes: read
Input fields: No input fields

`list_business_brand_assets`

List business logo brand assets, optionally scoped to a business profile and including archived assets or data URLs.

Scopes: read
Input fields: businessInfoId, includeArchived, includeDataUrl

`list_business_infos`

List business profiles used for invoices, expenses, and tax/reporting context.

Scopes: read
Input fields: No input fields

`list_email_templates`

List invoice/quote email templates, optionally filtered by template type.

Scopes: read
Input fields: type

`list_payment_methods`

List payment methods used on invoices and expenses.

Scopes: read
Input fields: No input fields

`set_default_business_info`

Set the default business profile and clear default status from the others.

Scopes: write
Input fields: businessInfoId

`set_default_email_template`

Set the default email template for its type and clear default status from other templates of the same type.

Scopes: write
Input fields: emailTemplateId

`set_default_payment_method`

Set the default payment method and clear default status from the others.

Scopes: write
Input fields: paymentMethodId

`unarchive_business_brand_asset`

Restore an archived business logo brand asset without changing invoices or business profile references.

Scopes: write
Input fields: businessBrandAssetId

`update_business_brand_asset`

Update a business logo brand asset without deleting invoices or business profile references.

Scopes: write
Input fields: businessBrandAssetId, updates

`update_business_info`

Update a business profile without deleting invoices, expenses, or brand assets.

Scopes: write
Input fields: businessInfoId, updates

`update_email_template`

Update an invoice or quote email template.

Scopes: write
Input fields: emailTemplateId, updates

`update_payment_method`

Update a payment method without deleting invoices or expenses that reference older snapshots.

Scopes: write
Input fields: paymentMethodId, updates

`update_preferences`

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.

Scopes: write
Input fields: updates

Reports, Exports, and Backups

Read reports, export files through the browser app, and manage local or cloud backups.

`create_cloud_backup`

Create a TaskTime Pro backup snapshot in the active cloud provider using the existing backup manager.

Scopes: readexport
Input fields: No input fields

`create_drive_backup`

Deprecated Google Drive compatibility alias for create_cloud_backup. Create a TaskTime Pro backup snapshot in Google Drive.

Scopes: readexport
Input fields: No input fields

`download_cloud_backup_json`

Download a selected backup from the active cloud provider as a browser JSON file without returning backup contents through the bridge.

Scopes: readexport
Input fields: backupId, filename

`download_drive_backup_json`

Deprecated Google Drive compatibility alias for download_cloud_backup_json. Download a selected Google Drive backup as a browser JSON file without returning backup contents through the bridge.

Scopes: readexport
Input fields: backupId, filename

`export_accountant_pack`

Generate and download the Reports accountant pack ZIP in the paired browser app session without returning file contents through the bridge.

Scopes: readexport
Input fields: period, customStart, customEnd, businessId, clientId, projectId, categoryId, invoiceStatus, expenseStatus, incomeDateBasis, expenseDateBasis, rowLimit, filename, includeInvoicePdfs

`export_backup_json`

Export all TaskTime Pro backup data as a browser-downloaded JSON file without returning backup contents through the bridge.

Scopes: readexport
Input fields: filename, exportDate, refreshFromCloud

`export_report_csv`

Generate and download a CSV export for a Reports-page section in the paired browser app session without returning file contents through the bridge.

Scopes: readexport
Input fields: section, period, customStart, customEnd, businessId, clientId, projectId, categoryId, invoiceStatus, expenseStatus, incomeDateBasis, expenseDateBasis, rowLimit, filename

`export_report_pdf`

Generate and download a PDF export for Reports-page sections that have existing UI PDF exporters, without returning file contents through the bridge.

Scopes: readexport
Input fields: section, period, customStart, customEnd, businessId, clientId, projectId, categoryId, invoiceStatus, expenseStatus, incomeDateBasis, expenseDateBasis, rowLimit, filename

`get_report_summary`

Get the Free basic current-month Overview with scope=basic-current-month, or Pro advanced Reports summaries. Omitted scope remains advanced.

Scopes: read
Input fields: scope, section, period, customStart, customEnd, businessId, clientId, projectId, categoryId, invoiceStatus, expenseStatus, incomeDateBasis, expenseDateBasis, includeRows, rowLimit

`list_cloud_backups`

List TaskTime Pro backup snapshots in the active cloud provider without returning backup contents.

Scopes: readexport
Input fields: No input fields

`list_drive_backups`

Deprecated Google Drive compatibility alias for list_cloud_backups. List TaskTime Pro backup snapshots in Google Drive without returning backup contents.

Scopes: readexport
Input fields: No input fields

`preview_backup_import_json`

Validate a TaskTime Pro backup JSON payload and return version/count metadata without changing current data.

Scopes: read
Input fields: backupJson

`restore_backup_json`

Approval gated

Replace current local TaskTime Pro data with a validated backup JSON payload after explicit confirmation and TaskTime Pro approval. Requires confirmationText to equal RESTORE.

Scopes: readwriteexport
Input fields: backupJson, confirmRestore, confirmationText
Approval: Valid exact-input approval token or visible prompt

`restore_cloud_backup`

Approval gated

Replace current local TaskTime Pro data from a selected backup in the active cloud provider after explicit confirmation and TaskTime Pro approval. Requires confirmationText to equal RESTORE.

Scopes: readwriteexport
Input fields: backupId, confirmRestore, confirmationText
Approval: Valid exact-input approval token or visible prompt

`restore_drive_backup`

Approval gated

Deprecated Google Drive compatibility alias for restore_cloud_backup. Replace current local TaskTime Pro data from a selected Google Drive backup after explicit confirmation and TaskTime Pro approval. Requires confirmationText to equal RESTORE.

Scopes: readwriteexport
Input fields: backupId, confirmRestore, confirmationText
Approval: Valid exact-input approval token or visible prompt

Sync and Account

Inspect sync status, update explicit sync settings, and handle account-level data operations.

`delete_all_account_data`

Approval gated

Delete all local TaskTime Pro data and, when cloud storage is connected, wipe all TaskTime sync data and backups and revoke the active provider after explicit confirmation and TaskTime Pro approval. Requires confirmationText to equal DELETE ALL DATA.

Scopes: readwriteexport
Input fields: confirmDelete, confirmationText, includeCloudData, includeDriveData
Approval: Valid exact-input approval token or visible prompt

`get_sync_status`

Read the active cloud provider, sync status, auto-sync mode, pending changes, and backup preference metadata.

Scopes: read
Input fields: No input fields

`update_sync_settings`

Update explicit cloud sync and backup preferences for the active provider. Backup mode requires confirmBackupMode: true. Optional runSync triggers Sync Now after saving.

Scopes: readwriteexport
Input fields: autoSyncEnabled, autoSyncMode, backupEnabled, backupFrequencyHours, confirmBackupMode, runSync

Navigation

Open TaskTime Pro screens in the paired browser session for human review.

`focus_running_timer`

Focus the TaskTime Pro app on a running timer by timer key or task ID.

Scopes: navigation
Input fields: timerKey, taskId

`open_account_view`

Open the TaskTime Pro account route, optionally focused on a specific Account section.

Scopes: navigation
Input fields: section

`open_client_view`

Open a client view in the paired TaskTime Pro app session after validating the client exists.

Scopes: navigation
Input fields: clientId

`open_dashboard_view`

Open the TaskTime Pro dashboard route in the paired app session.

Scopes: navigation
Input fields: No input fields

`open_expenses_view`

Open the expenses route, optionally scoped by client or project.

Scopes: navigation
Input fields: clientId, projectId

`open_invoice_view`

Open the invoices route, optionally focused on an existing invoice.

Scopes: navigation
Input fields: invoiceId

`open_planner_view`

Open the TaskTime Pro planner route, optionally for a specific year and week.

Scopes: navigation
Input fields: year, week

`open_project_view`

Open a project view in the paired TaskTime Pro app session after validating the project exists.

Scopes: navigation
Input fields: projectId

`open_reports_view`

Open the TaskTime Pro reports route in the paired app session.

Scopes: navigation
Input fields: No input fields

Queries and Summaries

Read dashboard, project, client, unbilled-work, and recent-entry summaries.

`find_unbilled_time`

Find canonical invoice-eligible time across complete local history, optionally scoped by project or task.

Scopes: read
Input fields: projectId, taskId, limit

`get_dashboard_summary`

Get a bounded summary of current work and canonical invoice-eligible time across complete local history.

Scopes: read
Input fields: No input fields

`get_email_send_status`

Read one durable hosted-email attempt without contacting the provider or sending/retrying a message.

Scopes: reademail
Input fields: attemptId

`list_recent_entries`

List recent entries across complete local history with actual and billable duration summaries.

Scopes: read
Input fields: projectId, taskId, limit