List todos from Things 3 with optional filters and pagination.

Returns todos matching the specified criteria. Use "status" to filter by list (inbox, today, upcoming, anytime, someday, logbook). Combine with projectId, areaId, tag, or search filters to narrow results.

Args:

• status: Filter by Things 3 list name

• projectId: Filter by project ID (get IDs from things3_get_projects)

• areaId: Filter by area ID (get IDs from things3_get_areas)

• tag: Filter by tag name (get names from things3_get_tags)

• search: Case-insensitive substring match against title and notes

• limit: Max results to return (default 50, max 200)

• offset: Number of results to skip for pagination (default 0)

Returns: { items: Todo[], total_available, offset, limit, has_more }

Get a single todo by its ID from Things 3.

Returns full details including title, notes, checklist items, due date, tags, project, and area.

Args:

• id: The unique Things 3 todo ID

Returns: Todo object with all fields

List all projects in Things 3 with pagination.

Returns projects with their status, area, tags, and dates. Use the returned project IDs to filter todos or assign new todos to a project.

Args:

• limit: Max results to return (default 50, max 200)

• offset: Number of results to skip for pagination (default 0)

Returns: { items: Project[], total_available, offset, limit, has_more }

List all areas of responsibility in Things 3.

Returns area IDs, names, and tags. Use area IDs to filter todos or assign projects to an area.

Returns: Array of { id, name, tags }

List all tags defined in Things 3.

Returns tag IDs and names. Use tag names to filter todos or apply tags when creating/updating todos.

Returns: Array of { id, name }

Create a new todo in Things 3.

Supports title, notes, scheduling, deadline, tags, project assignment, heading placement, and checklist items.

Args:

• title: Title of the todo (required)

• notes: Markdown notes/description

• when: Schedule — "today", "evening", "tomorrow", "someday", or a date (YYYY-MM-DD)

• deadline: Deadline date in YYYY-MM-DD format

• tags: Array of tag names to apply (tags must already exist in Things 3)

• projectId: ID of the project to add this todo to (get IDs from things3_get_projects)

• heading: Heading within the project to place this todo under (requires projectId)

• checklistItems: Array of checklist item strings

Returns: { id, name } of the created todo

Create a new project in Things 3.

Args:

• title: Title of the project (required)

• notes: Markdown notes/description

• areaId: ID of the area to assign this project to (get IDs from things3_get_areas)

• tags: Array of tag names to apply (tags must already exist in Things 3)

• when: Schedule — "today", "evening", "tomorrow", "someday", or YYYY-MM-DD

• deadline: Deadline date in YYYY-MM-DD format

Returns: { id, name } of the created project

Update an existing todo in Things 3 by ID.

Only provided fields are updated; omitted fields are left unchanged. Note: tags specified in addTags are added to existing tags, not replaced.

Args:

• id: The unique ID of the todo to update (required)

• title: New title

• notes: New notes (replaces existing notes via URL scheme — append manually if needed)

• when: Reschedule — "today", "evening", "tomorrow", "someday", or YYYY-MM-DD

• deadline: New deadline in YYYY-MM-DD format

• addTags: Tag names to add to the todo

• completed: Set to true to mark complete, false to mark incomplete

Returns: { success, id, name }

Mark a todo as complete in Things 3.

Args:

• id: The unique ID of the todo to complete (required)

Returns: { success, id, name }

Move a todo to the Trash in Things 3.

This does NOT permanently delete it — the todo can be recovered from Trash inside Things 3.

Args:

• id: The unique ID of the todo to trash (required)

Returns: { success, id, name }