Task Management

# Natural language examples
"Create a task: buy groceries"
"Add a todo: finish project report"
"Remind me to call the dentist"
"Create task 'Review PR' due tomorrow"

{
  "success": true,
  "task_id": "task_abc123",
  "message": "Task 'Buy groceries' created successfully.",
  "task": {
    "id": "task_abc123",
    "title": "Buy groceries",
    "status": "needsAction",
    "due": "2026-03-10T00:00:00Z",
    "notes": "milk, eggs, bread"
  }
}

"Show me my tasks"
"What's on my todo list?"
"List all my incomplete tasks"

{
  "success": true,
  "message": "Found 3 task(s).",
  "tasks": [
    {
      "id": "task_abc123",
      "title": "Buy groceries",
      "status": "needsAction",
      "due": "2026-03-10T00:00:00Z",
      "notes": "milk, eggs, bread",
      "updated": "2026-03-08T10:30:00Z"
    }
  ],
  "list_id": "primary_list_id"
}

"Mark 'buy groceries' as done"
"I finished the project report"
"Complete the dentist task"

"Mark 'buy groceries' as incomplete"
"Reopen the project task"
"Uncomplete that task"

"Change the title of my task to 'Buy groceries and supplies'"
"Update the due date to next Friday"
"Add notes to the project task: 'needs review from Sarah'"

"Delete the groceries task"
"Remove my dentist reminder"
"Delete task XYZ"

"Show me my task lists"
"What task lists do I have?"
"List all my todo lists"

{
  "success": true,
  "message": "Found 3 task list(s).",
  "lists": [
    {
      "id": "list_abc123",
      "title": "My Tasks",
      "updated": "2026-03-08T12:00:00Z"
    },
    {
      "id": "list_def456",
      "title": "Work Projects",
      "updated": "2026-03-07T09:30:00Z"
    }
  ]
}

2026-03-15T00:00:00Z

from agent.date_utils import parse_datetime

# Natural language input
date_str = "tomorrow"
iso_date, is_all_day = parse_datetime(date_str)
# Returns: ("2026-03-09T00:00:00", True)

class TasksService:
    def __init__(self, service):
        """Initialize with authenticated Google Tasks service."""
        self.service = service
        self._default_list_id = None

def _get_default_list_id(self) -> Optional[str]:
    """Get the default task list ID (cached)."""
    if self._default_list_id:
        return self._default_list_id
    
    try:
        lists = self.service.tasklists().list().execute()
        items = lists.get("items", [])
        if items:
            self._default_list_id = items[0]["id"]
            return self._default_list_id
    except Exception:
        pass
    return None

User: "Create a task: buy groceries"
Agent: "Task 'buy groceries' created successfully."

User: "Add a todo: finish report, due Friday"
Agent: [Parses "Friday" to ISO date]
"Task 'finish report' created with due date March 12, 2026."

User: "Show me my tasks"
Agent: "You have 5 tasks:
1. Buy groceries
2. Call dentist
3. Finish report
..."

User: "Mark tasks 1 and 2 as done"
Agent: "Marked 'Buy groceries' as completed.
Marked 'Call dentist' as completed."

User: "List my tasks"
Agent: "Task 'Buy milk' is on your list."

User: "Change it to 'Buy milk and eggs'"
Agent: [Updates task title]
"Task updated successfully."

User: "Show me my task lists"
Agent: "You have 2 lists:
1. My Tasks
2. Work Projects"

User: "Create a task 'Review code' in Work Projects"
Agent: [Creates task in specified list]
"Task created in 'Work Projects' list."

try:
    result = tasks_service.mark_task_complete(
        task_id="invalid_id"
    )
except HttpError as error:
    if error.resp.status == 404:
        return {
            "success": False,
            "message": f"Task '{task_id}' not found.",
            "error": str(error)
        }

create_task(
    title="Review PR #123",
    notes="Check for test coverage, security issues, and code style"
)

"Create task 'Submit report' due Friday"

"Show me my tasks"  # Daily review
"List completed tasks"  # Weekly cleanup