list_entries
Read-only
Retrieve tasks, notes, and events from Bullet. Use preset views for inbox or overdue items, or query by date period with filters. Paginated results support cursor for next page.
Instructions
List tasks, notes, and events from Bullet. Two modes: (1) use 'view' for presets (inbox=unscheduled, overdue=past-due), or (2) use period+date for calendar queries. Each mode has different valid filters — see parameter descriptions. Returns paginated results; use cursor for next page.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Filter by tag ID. Pass an array to match any. Works with view=overdue or without a view. Not valid with view=inbox. Use list_tags to find IDs. | |
| date | No | Anchor date for period queries. Format must match period: YYYY-MM-DD for day/week, YYYY-MM for month, YYYY for year. Defaults to current date if omitted. Cannot be used with a view. | |
| kind | No | Filter by entry type. Pass an array to match any. Works with view=inbox or without a view. Not valid with view=overdue. | |
| view | No | Preset view. 'inbox' = unscheduled entries (supports status, kind filters). 'overdue' = past-due tasks (supports collection, tag filters). Omit to query by period/date instead. | |
| limit | No | Max entries to return (1-200, default 50). | |
| cursor | No | Pagination cursor from a previous list_entries response. Pass this to get the next page. | |
| expand | No | Include related objects in the response. 'collection' inlines the collection object, 'tags' inlines tag objects. Pass an array for both. | |
| period | No | Time granularity for date-based queries. Cannot be used with a view. If date is set, period controls its scope (day=single day, week=that week, etc). Defaults date to now if omitted. | |
| status | No | Filter by task status. Pass an array to match any. Works with view=inbox or without a view. Not valid with view=overdue. | |
| collection | No | Filter by collection ID. Pass an array to match any. Works with view=overdue or without a view. Not valid with view=inbox. Use list_collections to find IDs. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | Yes | ||
| entries | Yes | ||
| has_more | Yes |