Args:
----
    count: Number of random items to return. Defaults to 5.

Note: The Anytime list can contain both todos and projects. This returns a
random subset without filtering types.

Args:
----
    count: Number of random items to return. Defaults to 5.

Args:
----
    period: Time period to look back (e.g., '3d', '1w', '2m', '1y'). Defaults to '7d'.
    limit: Maximum number of entries to return. Defaults to 50.

Args:
----
    project_uuid: Optional UUID of a specific project to get todos from.

Args:
----
    project_uuid: Optional UUID of a specific project to draw todos from.
    count: Number of todos to return. Defaults to 5.

Args:
----
    include_items: Include tasks within projects.

Args:
----
    include_items: Include projects and tasks within areas

Args:
----
    include_items: Include items tagged with each tag

Args:
----
    tag: Tag title to filter by

Args:
----
    query: Search term to look for in todo titles and notes

Args:
----
    status: Filter by todo status (incomplete/completed/canceled)
    start_date: Filter by start date (YYYY-MM-DD)
    deadline: Filter by deadline (YYYY-MM-DD)
    tag: Filter by tag
    area: Filter by area UUID
    type: Filter by item type (to-do/project/heading)

Args:
----
    title: Title of the todo
    notes: Notes for the todo
    when: When to schedule the todo (today, tomorrow, evening, anytime, someday, or YYYY-MM-DD)
    deadline: Deadline for the todo (YYYY-MM-DD)
    tags: Tags to apply to the todo. IMPORTANT: Always pass as an array of
        strings (e.g., ["tag1", "tag2"]) NOT as a comma-separated string.
        Passing as a string will treat each character as a separate tag.
    list_id: ID of project/area to add to (takes priority over list_title if both provided)
    list_title: Title of project/area to add to (must exactly match an existing area or project title — look them up with get_areas or get_projects).
        If both list_id and list_title are provided, list_id takes priority.

Args:
----
    title: Title of the project
    notes: Notes for the project
    when: When to schedule the project
    deadline: Deadline for the project
    tags: Tags to apply to the project. IMPORTANT: Always pass as an array of
        strings (e.g., ["tag1", "tag2"]) NOT as a comma-separated string.
        Passing as a string will treat each character as a separate tag.
    area_id: ID of area to add to
    area_title: Title of area to add to (must exactly match an existing area title — look them up with get_areas)
    todos: Initial todos to create in the project

Args:
----
    id: ID of the todo to update.
    title: New title.
    notes: New notes.
    when: When to schedule the todo (today, tomorrow, anytime, someday, or YYYY-MM-DD).
    deadline: New deadline (YYYY-MM-DD).
    tags: New tags. IMPORTANT: Always pass as an array of strings (e.g., ["tag1", "tag2"]) NOT as a comma-separated string. Passing as a string will treat each character as a separate tag.
    completed: Mark as completed.
    canceled: Mark as canceled.
    list_id: ID of project/area to move the todo to (takes priority over list_name if both provided).
    list_name: Name of built-in list, project, or area to move the todo to. For built-in lists use: "Inbox", "Today", "Anytime", "Someday". For projects or areas, use the exact name.
        If both list_id and list_name are provided, list_id takes priority.

Args:
----
    id: ID of the project to update
    title: New title
    notes: New notes
    when: New schedule (today, tomorrow, anytime, someday, or YYYY-MM-DD)
    deadline: New deadline (YYYY-MM-DD)
    tags: New tags. IMPORTANT: Always pass as an array of strings (e.g., ["tag1", "tag2"]) NOT as a comma-separated string. Passing as a string will treat each character as a separate tag.
    completed: Mark as completed
    canceled: Mark as canceled
    list_name: Move project directly to a built-in list. Must be one of:
              - "Today": Move to Today list
              - "Anytime": Move to Anytime list
              - "Someday": Move to Someday list
              - "Trash": Move to trash
              Note: Projects cannot be moved to Inbox or Logbook. To move a project
              to Logbook, mark it as completed instead.
    area_title: Title of the area to move the project to
    area_id: ID of the area to move the project to

Args:
----
    id: ID of item to show, or one of: inbox, today, upcoming, anytime, someday, logbook
    query: Optional query to filter by
    filter_tags: Optional tags to filter by. IMPORTANT: Always pass as an
    array of strings (e.g., ["tag1", "tag2"]) NOT as a comma-separated
    string. Passing as a string will treat each character as a separate tag.

Args:
----
    query: Search query

Args:
----
    period: Time period (e.g., '3d', '1w', '2m', '1y')