# TaskTime Pro (npm · @tasktimepro/agent-bridge)

First-party local TaskTime Pro tools for tasks, timers, expenses, invoices, reports, and planning.

- Trust score: 79/100 (medium)
- Change this week: −8
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@tasktimepro/agent-bridge`: 79/100 (this document), [markdown](https://verifymcp.io/servers/pro-tasktime-agent-bridge/tasktimepro-agent-bridge.md), [page](https://verifymcp.io/servers/pro-tasktime-agent-bridge/tasktimepro-agent-bridge)

## Channel facts

- Registry: `npm`
- Package: `@tasktimepro/agent-bridge`
- Version: `1.0.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - No production dependencies, so there is no dependency health to assess.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to tasktimepro/tasktime).
  - Clear OSI-approved license (AGPL-3.0-only).
  - Actively maintained (last published 11 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 7408 tokens (~60/item across 122 items; 122 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 67/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add pro-tasktime-agent-bridge -- npx -y @tasktimepro/agent-bridge
```

### Codex

```bash
codex mcp add pro-tasktime-agent-bridge -- npx -y @tasktimepro/agent-bridge
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pro-tasktime-agent-bridge": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@tasktimepro/agent-bridge"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add pro-tasktime-agent-bridge --command npx --arg -y --arg @tasktimepro/agent-bridge
```

### Hermes

```yaml
mcp_servers:
  pro-tasktime-agent-bridge:
    command: "npx"
    args: ["-y", "@tasktimepro/agent-bridge"]
```

### Other

```json
{
  "mcpServers": {
    "pro-tasktime-agent-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@tasktimepro/agent-bridge"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 79, +4)

- [functional improvement] Stability: unverified → 0.23

### 2026-08-02 (score 75, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-07-31 (score 60, −9)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 69, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 87, +28)

- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Tool coverage: 0
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: pass
- [functional] First check of Schema quality: good

### 2026-07-26 (score 59)

First indexed and scored.

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (122)

### `add_manual_time_entry` (~79 tokens)

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

Input parameters:

- `billingIncrementMinutes` (number|null)
- `end` (number, required)
- `idempotencyKey` (string)
- `note` (string)
- `start` (number, required)
- `taskId` (string, required)

### `archive_business_brand_asset` (~34 tokens)

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

Input parameters:

- `businessBrandAssetId` (string, required)

### `archive_client` (~25 tokens)

Archive an existing client without deleting related data.

Input parameters:

- `clientId` (string, required)

### `archive_expense_category` (~33 tokens)

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

Input parameters:

- `expenseCategoryId` (string, required)

### `archive_project` (~25 tokens)

Archive an existing project without deleting related data.

Input parameters:

- `projectId` (string, required)

### `archive_task` (~33 tokens)

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

Input parameters:

- `taskId` (string, required)

### `attach_planner_item` (~121 tokens)

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

Input parameters:

- `date` (string|null)
- `duplicateMode` (string)
- `estimatedHours` (number|null)
- `idempotencyKey` (string)
- `includeWeekends` (boolean)
- `mode` (string, required)
- `referenceId` (string, required)
- `type` (string, required)
- `weekStartDate` (string|null)
- `weekday` (number|null)

### `cascade_delete_client` (~167 tokens)

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.

Input parameters:

- `alsoDeleteProjects` (boolean)
- `clientId` (string, required)
- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `expectedExpenseIds` (array)
- `expectedPlannerAttachmentIds` (array)
- `expectedProjectIdsToConvertToPersonal` (array)
- `expectedProjectIdsToDelete` (array)
- `expectedRecurrenceIds` (array)
- `expectedTaskIds` (array)
- `expectedTimeEntryIds` (array)
- `expectedTimerKeys` (array)

### `cascade_delete_project` (~140 tokens)

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.

Input parameters:

- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `expectedExpenseIds` (array)
- `expectedPlannerAttachmentIds` (array)
- `expectedRecurrenceIds` (array)
- `expectedTaskIds` (array, required)
- `expectedTimeEntryIds` (array, required)
- `expectedTimerKeys` (array)
- `projectId` (string, required)

### `cascade_delete_task` (~111 tokens)

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.

Input parameters:

- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `expectedPlannerAttachmentIds` (array)
- `expectedTaskIds` (array, required)
- `expectedTimeEntryIds` (array, required)
- `expectedTimerKeys` (array)
- `taskId` (string, required)

### `clear_timer` (~59 tokens)

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

Input parameters:

- `confirmClear` (boolean, required)
- `confirmationText` (string, required)
- `taskId` (string)
- `timerKey` (string)

### `complete_task` (~36 tokens)

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

Input parameters:

- `occurrenceDate` (string)
- `taskId` (string, required)

### `create_business_brand_asset` (~121 tokens)

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

Input parameters:

- `businessInfoId` (string, required)
- `byteSize` (number, required)
- `contentHash` (string, required)
- `dataUrl` (string, required)
- `fileName` (string|null)
- `height` (number, required)
- `id` (string)
- `idempotencyKey` (string)
- `kind` (string)
- `mimeType` (string, required)
- `width` (number, required)

### `create_business_info` (~186 tokens)

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

Input parameters:

- `address` (string)
- `branding` (object)
- `businessName` (string)
- `city` (string)
- `country` (string)
- `email` (string)
- `id` (string)
- `idempotencyKey` (string)
- `isDefault` (boolean)
- `name` (string)
- `phone` (string)
- `registrationNumber` (string)
- `state` (string)
- `taxEnabled` (boolean)
- `taxId` (string)
- `taxLabel` (string)
- `taxNumber` (string)
- `taxRate` (number)
- `title` (string)
- `vat` (string)
- `zip` (string)

### `create_client` (~199 tokens)

Create a non-archived TaskTime Pro client with contact, billing, tax, and notes fields.

Input parameters:

- `address` (string)
- `city` (string)
- `clientName` (string)
- `color` (string|null)
- `contactPerson` (string)
- `country` (string)
- `defaultCurrency` (string)
- `defaultHourlyRate` (number|null)
- `disableTax` (boolean)
- `email` (string)
- `flatRate` (boolean)
- `hourlyRate` (number|null)
- `id` (string)
- `idempotencyKey` (string)
- `notes` (string)
- `phone` (string)
- `registrationNumber` (string)
- `state` (string)
- `taxNumber` (string)
- `title` (string, required)
- `vat` (string)
- `zip` (string)

### `create_email_template` (~115 tokens)

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

Input parameters:

- `attachmentTitle` (string, required)
- `fromName` (string)
- `id` (string)
- `idempotencyKey` (string)
- `isDefault` (boolean)
- `name` (string, required)
- `reminderBody` (string, required)
- `replyTo` (string)
- `sendBody` (string, required)
- `subject` (string, required)
- `type` (string, required)

### `create_expense` (~244 tokens)

Create an expense through the TaskTime Pro command layer.

Input parameters:

- `amount` (number, required)
- `amountExcludingTax` (number|null)
- `amountType` (string|null)
- `billable` (boolean, required)
- `businessId` (string|null)
- `categoryId` (string|null)
- `clientId` (string|null)
- `currency` (string, required)
- `date` (string, required)
- `idempotencyKey` (string)
- `isPersonal` (boolean, required)
- `isRecurring` (boolean)
- `isTaxExempt` (boolean)
- `note` (string|null)
- `paidBy` (string|null)
- `paidOn` (string|null)
- `paymentMode` (string)
- `paymentStatus` (string)
- `projectId` (string|null)
- `receiptNumber` (string|null)
- `recurrenceId` (string|null)
- `supplierName` (string|null)
- `taxLabel` (string|null)
- `taxNumber` (string|null)
- `taxRate` (number|null)
- `title` (string, required)

### `create_expense_category` (~71 tokens)

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

Input parameters:

- `archived` (boolean)
- `group` (string|null)
- `id` (string)
- `idempotencyKey` (string)
- `isDefault` (boolean)
- `name` (string, required)

### `create_expense_recurrence` (~267 tokens)

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

Input parameters:

- `active` (boolean)
- `amount` (number, required)
- `amountExcludingTax` (number|null)
- `amountType` (string, required)
- `billable` (boolean, required)
- `businessId` (string|null)
- `categoryId` (string|null)
- `clientId` (string|null)
- `currency` (string, required)
- `endDate` (string|null)
- `generateInitial` (boolean)
- `id` (string)
- `idempotencyKey` (string)
- `isPersonal` (boolean, required)
- `isTaxExempt` (boolean, required)
- `monthlyDay` (number)
- `monthlyType` (string)
- `note` (string|null)
- `paidBy` (string|null)
- `paymentMode` (string)
- `projectId` (string|null)
- `repeat` (string, required)
- `startDate` (string, required)
- `supplierName` (string|null)
- `taxLabel` (string|null)
- `taxNumber` (string|null)
- `taxRate` (number|null)
- `title` (string, required)

### `create_invoice_draft` (~177 tokens)

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.

Input parameters:

- `billingPeriodEnd` (string)
- `billingPeriodStart` (string)
- `businessInfoId` (string|null)
- `clientId` (string)
- `dueDate` (string|null)
- `exchangeRates` (object|null)
- `idempotencyKey` (string)
- `includeClientLevelExpenses` (boolean)
- `invoiceDate` (string)
- `invoiceNumber` (string)
- `notes` (string)
- `paymentMethodId` (string|null)
- `projectId` (string, required)
- `templateId` (string|null)

### `create_invoice_template` (~149 tokens)

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

Input parameters:

- `brandingOptions` (object)
- `currentSequentialNumber` (number)
- `defaultDueDays` (number)
- `defaultNotes` (string)
- `defaultTaxRate` (number)
- `id` (string)
- `idempotencyKey` (string)
- `isDefault` (boolean)
- `layoutStyle` (string)
- `logoPlacement` (string)
- `name` (string, required)
- `prefix` (string)
- `showBillingPeriod` (boolean)
- `showProjectTitle` (boolean)
- `useSequentialNumbers` (boolean)

### `create_payment_method` (~113 tokens)

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

Input parameters:

- `bank` (string)
- `bankAddress` (string)
- `custom` (array)
- `fullName` (string)
- `iban` (string)
- `id` (string)
- `idempotencyKey` (string)
- `instructions` (string)
- `isDefault` (boolean)
- `paypal` (string)
- `swift` (string)
- `title` (string, required)

### `create_project` (~154 tokens)

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

Input parameters:

- `billableTimeIncrementMinutes` (number|null)
- `budgetAmount` (number|null)
- `color` (string|null)
- `deadline` (string|null)
- `description` (string)
- `flatRate` (boolean)
- `hourlyRate` (number|null)
- `id` (string)
- `idempotencyKey` (string)
- `isPersonal` (boolean)
- `preferredClientId` (string|null)
- `statusMode` (string)
- `taskSort` (string)
- `taskView` (string)
- `title` (string, required)

### `create_task` (~121 tokens)

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

Input parameters:

- `billable` (boolean)
- `estimatedFlatAmount` (number|null)
- `estimatedHours` (number|null)
- `idempotencyKey` (string)
- `note` (string|null)
- `parentTaskId` (string|null)
- `projectId` (string|null)
- `promptTimeEntry` (boolean)
- `recurring` (object|null)
- `startDate` (string|null)
- `title` (string, required)

### `create_tax_return_period` (~119 tokens)

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

Input parameters:

- `businessInfoId` (string|null)
- `endDate` (string, required)
- `filedAt` (number|null)
- `id` (string)
- `idempotencyKey` (string)
- `notes` (string|null)
- `paidAt` (number|null)
- `startDate` (string, required)
- `status` (string)
- `title` (string, required)
- `type` (string, required)

### `delete_business_brand_asset` (~66 tokens)

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.

Input parameters:

- `businessBrandAssetId` (string, required)
- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)

### `delete_business_info` (~71 tokens)

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.

Input parameters:

- `businessInfoId` (string, required)
- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)

### `delete_client` (~48 tokens)

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

Input parameters:

- `clientId` (string, required)
- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)

### `delete_email_template` (~51 tokens)

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

Input parameters:

- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `emailTemplateId` (string, required)

### `delete_expense` (~63 tokens)

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

Input parameters:

- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `expenseId` (string, required)

### `delete_expense_category` (~62 tokens)

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

Input parameters:

- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `expenseCategoryId` (string, required)

### `delete_expense_recurrence` (~55 tokens)

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

Input parameters:

- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `recurrenceId` (string, required)

### `delete_invoice_template` (~58 tokens)

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

Input parameters:

- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `invoiceTemplateId` (string, required)

### `delete_payment_method` (~59 tokens)

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

Input parameters:

- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `paymentMethodId` (string, required)

### `delete_project` (~48 tokens)

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

Input parameters:

- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `projectId` (string, required)

### `delete_task` (~51 tokens)

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

Input parameters:

- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `taskId` (string, required)

### `delete_time_entry` (~58 tokens)

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

Input parameters:

- `confirmDelete` (boolean, required)
- `confirmationText` (string, required)
- `entryId` (string, required)

### `find_unbilled_time` (~54 tokens)

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

Input parameters:

- `limit` (number)
- `projectId` (string|null)
- `taskId` (string|null)

### `focus_running_timer` (~42 tokens)

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

Input parameters:

- `taskId` (string)
- `timerKey` (string)

### `get_active_timers` (~21 tokens)

List active timers with resolved timer keys and elapsed time.

### `get_client_overview` (~32 tokens)

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

Input parameters:

- `clientId` (string, required)

### `get_dashboard_summary` (~27 tokens)

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

### `get_pairing_status` (~45 tokens)

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.

### `get_preferences` (~30 tokens)

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

### `get_project_notes` (~30 tokens)

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

Input parameters:

- `projectId` (string, required)

### `get_project_overview` (~34 tokens)

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

Input parameters:

- `projectId` (string, required)

### `get_report_summary` (~156 tokens)

Get read-only Reports-page summaries for filtered invoices, expenses, hours, tax, outstanding, statement, work-summary, and to-invoice sections.

Input parameters:

- `businessId` (string|null)
- `categoryId` (string|null)
- `clientId` (string|null)
- `customEnd` (string|null)
- `customStart` (string|null)
- `expenseDateBasis` (string)
- `expenseStatus` (string)
- `includeRows` (boolean)
- `incomeDateBasis` (string)
- `invoiceStatus` (string)
- `period` (string)
- `projectId` (string|null)
- `rowLimit` (number)
- `section` (string)

### `get_sync_status` (~28 tokens)

Read current Google Drive sync status, auto-sync mode, pending changes, and backup preference metadata.

### `list_business_brand_assets` (~56 tokens)

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

Input parameters:

- `businessInfoId` (string)
- `includeArchived` (boolean)
- `includeDataUrl` (boolean)

### `list_business_infos` (~24 tokens)

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

### `list_clients` (~28 tokens)

List TaskTime Pro clients visible to the paired app session.

Input parameters:

- `includeArchived` (boolean)

### `list_daily_goals` (~23 tokens)

List weekday daily planner goals.

Input parameters:

- `weekday` (number)

### `list_email_templates` (~30 tokens)

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

Input parameters:

- `type` (string|null)

### `list_expense_categories` (~40 tokens)

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

Input parameters:

- `includeArchived` (boolean)

### `list_expense_recurrences` (~52 tokens)

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

Input parameters:

- `activeOnly` (boolean)
- `clientId` (string|null)
- `projectId` (string|null)

### `list_expenses` (~51 tokens)

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

Input parameters:

- `billableOnly` (boolean)
- `clientId` (string|null)
- `projectId` (string|null)

### `list_invoice_templates` (~19 tokens)

List invoice templates, including sequence and branding defaults.

### `list_invoices` (~56 tokens)

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

Input parameters:

- `clientId` (string|null)
- `limit` (number)
- `projectId` (string|null)
- `status`

### `list_payment_methods` (~18 tokens)

List payment methods used on invoices and expenses.

### `list_planner_attachments` (~63 tokens)

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

Input parameters:

- `date` (string)
- `mode` (string)
- `referenceId` (string)
- `type` (string)
- `weekday` (number)

### `list_projects` (~21 tokens)

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

### `list_recent_entries` (~49 tokens)

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

Input parameters:

- `limit` (number)
- `projectId` (string|null)
- `taskId` (string|null)

### `list_tasks` (~30 tokens)

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

Input parameters:

- `projectId` (string|null)

### `list_tax_return_periods` (~23 tokens)

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

### `mark_expense_paid` (~56 tokens)

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

Input parameters:

- `amount` (number)
- `expenseId` (string, required)
- `paidBy` (string|null)
- `paidOn` (string|null)

### `mark_expense_unpaid` (~24 tokens)

Mark an expense unpaid.

Input parameters:

- `expenseId` (string, required)

### `mark_expenses_tax_claimed` (~59 tokens)

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

Input parameters:

- `confirmClaim` (boolean, required)
- `expenseIds` (array, required)
- `taxReturnPeriodId` (string, required)

### `mark_expenses_tax_unclaimed` (~48 tokens)

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

Input parameters:

- `confirmUnclaim` (boolean, required)
- `expenseIds` (array, required)

### `mark_tax_return_period_filed` (~53 tokens)

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

Input parameters:

- `confirmFiled` (boolean, required)
- `filedAt` (number)
- `taxReturnPeriodId` (string, required)

### `mark_tax_return_period_paid` (~60 tokens)

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

Input parameters:

- `confirmPaid` (boolean, required)
- `filedAt` (number)
- `paidAt` (number)
- `taxReturnPeriodId` (string, required)

### `open_account_view` (~32 tokens)

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

Input parameters:

- `section` (string)

### `open_client_view` (~35 tokens)

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

Input parameters:

- `clientId` (string, required)

### `open_dashboard_view` (~22 tokens)

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

### `open_expenses_view` (~38 tokens)

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

Input parameters:

- `clientId` (string)
- `projectId` (string)

### `open_invoice_view` (~29 tokens)

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

Input parameters:

- `invoiceId` (string)

### `open_planner_view` (~40 tokens)

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

Input parameters:

- `week` (number)
- `year` (number)

### `open_project_view` (~35 tokens)

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

Input parameters:

- `projectId` (string, required)

### `open_reports_view` (~22 tokens)

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

### `pause_expense_recurrence` (~30 tokens)

Pause a recurring expense template without deleting generated expenses.

Input parameters:

- `recurrenceId` (string, required)

### `pause_timer` (~42 tokens)

Pause a timer by timer key or task ID.

Input parameters:

- `pausedAt` (number)
- `taskId` (string)
- `timerKey` (string)

### `preview_backup_import_json` (~36 tokens)

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

Input parameters:

- `backupJson` (string, required)

### `preview_delete_client` (~50 tokens)

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

Input parameters:

- `alsoDeleteProjects` (boolean)
- `clientId` (string, required)
- `includeInvoiceDeletion` (boolean)

### `preview_delete_project` (~41 tokens)

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

Input parameters:

- `includeInvoiceDeletion` (boolean)
- `projectId` (string, required)

### `preview_delete_task` (~35 tokens)

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

Input parameters:

- `taskId` (string, required)

### `preview_invoice_email` (~117 tokens)

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

Input parameters:

- `attachmentTitle` (string|null)
- `body` (string|null)
- `forwardToSelf` (boolean)
- `fromName` (string|null)
- `invoiceId` (string, required)
- `replyTo` (string|null)
- `sendType` (string)
- `subject` (string|null)
- `templateId` (string|null)
- `to` (string|null)

### `preview_invoice_from_unbilled_work` (~86 tokens)

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

Input parameters:

- `billingPeriodEnd` (string)
- `billingPeriodStart` (string)
- `exchangeRates` (object|null)
- `includeClientLevelExpenses` (boolean)
- `projectId` (string, required)

### `preview_project_quote` (~113 tokens)

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

Input parameters:

- `additionalTasks` (array)
- `businessInfoId` (string|null)
- `clientId` (string|null)
- `invoiceTemplateId` (string|null)
- `note` (string)
- `paymentMethodId` (string|null)
- `projectId` (string, required)
- `quoteDate` (string)
- `quoteTasks` (array)
- `quoteTimestamp` (string)

### `preview_project_quote_email` (~188 tokens)

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

Input parameters:

- `additionalTasks` (array)
- `attachmentTitle` (string|null)
- `body` (string|null)
- `businessInfoId` (string|null)
- `clientId` (string|null)
- `emailTemplateId` (string|null)
- `forwardToSelf` (boolean)
- `fromName` (string|null)
- `invoiceTemplateId` (string|null)
- `note` (string)
- `paymentMethodId` (string|null)
- `projectId` (string, required)
- `quoteDate` (string)
- `quoteTasks` (array)
- `quoteTimestamp` (string)
- `replyTo` (string|null)
- `subject` (string|null)
- `to` (string|null)

### `refresh_pairing` (~46 tokens)

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_daily_goal` (~23 tokens)

Remove a weekday daily planner goal.

Input parameters:

- `weekday` (number, required)

### `remove_planner_attachment` (~29 tokens)

Remove one planner attachment without deleting the referenced entity.

Input parameters:

- `plannerAttachmentId` (string, required)

### `resume_expense_recurrence` (~32 tokens)

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

Input parameters:

- `recurrenceId` (string, required)

### `resume_timer` (~45 tokens)

Resume a paused timer by timer key or task ID.

Input parameters:

- `idempotencyKey` (string)
- `taskId` (string)
- `timerKey` (string)

### `set_daily_goal` (~44 tokens)

Set or clear a weekday daily planner goal.

Input parameters:

- `targetEarnings` (number|null)
- `targetHours` (number|null)
- `weekday` (number, required)

### `set_default_business_info` (~32 tokens)

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

Input parameters:

- `businessInfoId` (string, required)

### `set_default_email_template` (~39 tokens)

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

Input parameters:

- `emailTemplateId` (string, required)

### `set_default_invoice_template` (~32 tokens)

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

Input parameters:

- `invoiceTemplateId` (string, required)

### `set_default_payment_method` (~32 tokens)

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

Input parameters:

- `paymentMethodId` (string, required)

### `start_timer` (~51 tokens)

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

Input parameters:

- `idempotencyKey` (string)
- `note` (string)
- `taskId` (string, required)

### `stop_timer` (~53 tokens)

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

Input parameters:

- `idempotencyKey` (string)
- `taskId` (string)
- `timerKey` (string)

### `unarchive_business_brand_asset` (~36 tokens)

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

Input parameters:

- `businessBrandAssetId` (string, required)

### `unarchive_client` (~26 tokens)

Restore an archived client without changing related data.

Input parameters:

- `clientId` (string, required)

### `unarchive_expense_category` (~33 tokens)

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

Input parameters:

- `expenseCategoryId` (string, required)

### `unarchive_project` (~26 tokens)

Restore an archived project without changing related data.

Input parameters:

- `projectId` (string, required)

### `unarchive_task` (~36 tokens)

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

Input parameters:

- `taskId` (string, required)

### `update_business_brand_asset` (~41 tokens)

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

Input parameters:

- `businessBrandAssetId` (string, required)
- `updates` (object, required)

### `update_business_info` (~39 tokens)

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

Input parameters:

- `businessInfoId` (string, required)
- `updates` (object, required)

### `update_client` (~45 tokens)

Update non-destructive client fields such as contact, billing, tax, notes, hourly rate, and color.

Input parameters:

- `clientId` (string, required)
- `updates` (object, required)

### `update_email_template` (~33 tokens)

Update an invoice or quote email template.

Input parameters:

- `emailTemplateId` (string, required)
- `updates` (object, required)

### `update_expense_category` (~43 tokens)

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

Input parameters:

- `expenseCategoryId` (string, required)
- `updates` (object, required)

### `update_expense_recurrence` (~43 tokens)

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

Input parameters:

- `recurrenceId` (string, required)
- `updates` (object, required)

### `update_invoice_draft` (~65 tokens)

Edit allowed metadata, line items, totals, and UI composition fields on an existing draft invoice. This does not mark billing state, update task billing cutoffs, link projects, or advance invoice numbering.

Input parameters:

- `invoiceId` (string, required)
- `updates` (object, required)

### `update_invoice_template` (~39 tokens)

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

Input parameters:

- `invoiceTemplateId` (string, required)
- `updates` (object, required)

### `update_payment_method` (~39 tokens)

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

Input parameters:

- `paymentMethodId` (string, required)
- `updates` (object, required)

### `update_planner_attachment` (~37 tokens)

Update planner attachment options such as estimated hours.

Input parameters:

- `estimatedHours` (number|null)
- `plannerAttachmentId` (string, required)

### `update_preferences` (~61 tokens)

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.

Input parameters:

- `updates` (object, required)

### `update_project` (~49 tokens)

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

Input parameters:

- `projectId` (string, required)
- `updates` (object, required)

### `update_project_notes` (~60 tokens)

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

Input parameters:

- `clear` (boolean)
- `content` (object|null)
- `plainText` (string)
- `projectId` (string, required)

### `update_task` (~44 tokens)

Update a TaskTime Pro task through relationship and task-state invariants. Use complete_task for recurring occurrences.

Input parameters:

- `taskId` (string, required)
- `updates` (object, required)

### `update_tax_return_period` (~55 tokens)

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

Input parameters:

- `taxReturnPeriodId` (string, required)
- `updates` (object, required)

### `update_time_entry` (~88 tokens)

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

Input parameters:

- `billingIncrementMinutes` (number|null)
- `end` (number)
- `entryId` (string, required)
- `note` (string|null)
- `start` (number)
- `taskId` (string)

### `update_timer` (~50 tokens)

Update an active timer note and/or start timestamp.

Input parameters:

- `note` (string|null)
- `startTime` (number)
- `taskId` (string)
- `timerKey` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/pro-tasktime-agent-bridge/tasktimepro-agent-bridge#diagnostics

## Score history

- 2026-08-03: 79
- 2026-08-02: 75
- 2026-08-01: 60
- 2026-07-31: 60
- 2026-07-30: 69
- 2026-07-28: 87
- 2026-07-27: 87
- 2026-07-26: 59

## Links

- npm package: https://www.npmjs.com/package/@tasktimepro/agent-bridge
- Socket report: https://socket.dev/npm/package/@tasktimepro/agent-bridge
- Repository: https://github.com/tasktimepro/tasktime
- Website: https://tasktime.pro/agents/
- Changelog RSS feed: https://verifymcp.io/servers/pro-tasktime-agent-bridge/tasktimepro-agent-bridge/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/pro-tasktime-agent-bridge/tasktimepro-agent-bridge/changelog.json
- HTML version of this page: https://verifymcp.io/servers/pro-tasktime-agent-bridge/tasktimepro-agent-bridge