List all tasks with optional filtering.

Args: include_archived: Include archived tasks (default: False) status: Filter by status (PENDING, IN_PROGRESS, COMPLETED, CANCELED) tags: Filter by tags (OR logic) sort_by: Sort field (id, name, priority, deadline, status, planned_start, estimated_duration, created_at, updated_at) reverse: Reverse sort order

Returns: Dictionary with tasks list and metadata

Get detailed information about a specific task.

Args: task_id: The ID of the task to retrieve

Returns: Task details including notes

Create a new task.

Args: name: Task name (required) priority: Task priority (higher = more important, default from config) deadline: Deadline in ISO format with time (e.g., '2025-12-11T18:00:00') estimated_duration: Estimated duration in hours (e.g., 0.5 = 30min, 1.5 = 1h30m) tags: List of tags for categorization is_fixed: Whether schedule is fixed (won't be moved by optimizer) planned_start: Planned start datetime in ISO format (e.g., '2025-12-11T09:00:00') planned_end: Planned end datetime in ISO format (e.g., '2025-12-11T17:00:00')

Returns: Created task data with ID

Update an existing task.

Args: task_id: ID of the task to update name: New task name priority: New priority deadline: New deadline in ISO format with time (e.g., '2025-12-11T18:00:00') estimated_duration: New estimated duration in hours (e.g., 0.5 = 30min, 1.5 = 1h30m) tags: New tags list (replaces existing) is_fixed: New fixed status planned_start: New planned start datetime in ISO format (e.g., '2025-12-11T09:00:00') planned_end: New planned end datetime in ISO format (e.g., '2025-12-11T17:00:00')

Returns: Updated task data

Delete a task.

Args: task_id: ID of the task to delete hard: If True, permanently delete. If False, archive (soft delete).

Returns: Confirmation message

Restore an archived task.

Args: task_id: ID of the task to restore

Returns: Restored task data

Start working on a task.

Changes status from PENDING to IN_PROGRESS and records start time.

Args: task_id: ID of the task to start

Returns: Updated task data with status change confirmation

Mark a task as completed.

Changes status to COMPLETED and records end time.

Args: task_id: ID of the task to complete

Returns: Updated task data with completion confirmation

Pause a task (reset to PENDING).

Changes status back to PENDING and clears timestamps.

Args: task_id: ID of the task to pause

Returns: Updated task data

Cancel a task.

Changes status to CANCELED.

Args: task_id: ID of the task to cancel

Returns: Updated task data

Reopen a completed or canceled task.

Changes status back to PENDING.

Args: task_id: ID of the task to reopen

Returns: Updated task data

Fix actual start/end timestamps for a task.

Used to correct timestamps for historical accuracy. Past dates allowed.

Args: task_id: ID of the task to fix actual_start: New actual start in ISO format (e.g., '2025-12-13T09:00:00') actual_end: New actual end in ISO format (e.g., '2025-12-13T17:00:00') actual_duration: Explicit duration in hours (e.g., 0.5 = 30min, 1.5 = 1h30m) clear_start: Clear actual_start timestamp clear_end: Clear actual_end timestamp clear_duration: Clear actual_duration (use calculated value)

Returns: Updated task data with new timestamps

Get task statistics.

Args: period: Time period for statistics (all, 7d, 30d)

Returns: Statistics including counts by status, completion rates, etc.

Get statistics for all tags.

Returns: Tag statistics including task counts per tag

Get tasks that AI can potentially execute.

Returns PENDING or IN_PROGRESS tasks sorted by priority. Use this to find tasks to work on.

Args: tags: Filter by tags (e.g., ['coding', 'ai-executable']) limit: Maximum number of tasks to return

Returns: List of executable tasks with details

Decompose a large task into smaller subtasks.

This tool helps break down complex tasks into manageable subtasks. Subtasks can be linked with sequential dependencies and grouped by tag.

Note: Taskdog does not have parent-child relationships. Instead, use dependencies + tags + notes to express relationships.

Args: task_id: ID of the original task to decompose subtasks: List of subtask definitions, each with: - name: Subtask name (required) - estimated_duration: Hours to complete (required) - priority: Priority level (optional, inherits from original) - tags: Additional tags (optional) group_tag: Tag to add to all subtasks for grouping (e.g., 'feature-x') create_dependencies: If True, create sequential dependencies archive_original: If True, archive the original task after decomposition

Returns: Decomposition result with created subtask IDs

Add a dependency between two tasks.

The task will depend on the specified task (must be completed first).

Args: task_id: ID of the task that will have the dependency depends_on_id: ID of the task it depends on

Returns: Confirmation with updated task info

Remove a dependency between two tasks.

Args: task_id: ID of the task with the dependency depends_on_id: ID of the dependency to remove

Returns: Confirmation with updated task info

Set tags for a task (replaces existing tags).

Args: task_id: ID of the task tags: New list of tags

Returns: Updated task info with new tags

Update notes for a task.

Args: task_id: ID of the task content: New notes content (markdown)

Returns: Confirmation message

Get notes for a task.

Args: task_id: ID of the task

Returns: Task notes content

Delete a tag from the system.

Removes the tag and all its associations with tasks.

Args: tag_name: Name of the tag to delete

Returns: Confirmation with tag name and affected task count

List audit logs with optional filtering.

Args: task_id: Filter by task ID operation: Filter by operation type (e.g., 'create_task', 'complete_task') client_name: Filter by client name since: Filter logs after this datetime (ISO format, e.g., '2025-12-11T09:00:00') until: Filter logs before this datetime (ISO format, e.g., '2025-12-11T17:00:00'); a date-only value covers the whole day failed: If True, only show failed operations limit: Maximum number of logs to return

Returns: Dictionary with logs list and metadata

Get detailed information about a specific audit log entry.

Args: log_id: The ID of the audit log entry to retrieve

Returns: Detailed audit log entry including old and new values

Auto-generate optimal task schedules.

Schedules tasks with estimated_duration based on priority, deadlines, and dependencies. By default schedules on weekdays only and skips tasks that already have a planned_start (use force_override to override).

Args: algorithm: Algorithm name. One of: greedy (front-load), balanced (even distribution), backward (JIT from deadline), priority_first (priority only), earliest_deadline (EDF), round_robin (parallel progress), dependency_aware (CPM), genetic (evolutionary), monte_carlo (random sampling). Use list_algorithms() to discover available algorithms. max_hours_per_day: Maximum work hours per day (e.g., 6.0 or 8.0) start_date: Optimization start date in ISO format (e.g., '2025-12-15' or '2025-12-15T09:00:00'). Defaults to server current time when omitted. task_ids: Specific task IDs to optimize. If omitted, all schedulable tasks are considered. force_override: If True, override existing schedules include_all_days: If True, schedule on weekends and holidays too

Returns: Optimization result with successful_tasks, failed_tasks, daily_allocations, and summary metrics.

List available schedule optimization algorithms.

Returns metadata for each algorithm so callers can choose one appropriate for their workload.

Returns: Dict with algorithms (list of {name, display_name, description}) and total count.