# habits_list

> Search the authenticated user's habits (daily/weekly/monthly trackers like "Read My Bible", "Go to the Gym").

<!-- Source: https://docs.actuallycare.com/tools/habits/habits_list -->

Search the authenticated user's habits (daily/weekly/monthly trackers like "Read My Bible", "Go to the Gym"). Returns pagination info (total_count, has_more, offset, limit). Each result includes: id, display_id, name, habit_type, cadence, status, started_on, best_streak, created_at. Filter by status (active/paused/archived) or habit_type. For a single habit's full detail + checklist + trackers, use [`habits_get`](/tools/habits/habits_get). To mark a habit done for a day, use [`habits_log`](/tools/habits/habits_log).

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Search term — matches against habit name and tagline (case-insensitive partial match) |
| `status` | enum | No | Filter by status (default: all) · One of: `all`, `active`, `paused`, `archived` |
| `habit_type` | string | No | Filter by habit type (e.g. bible, gym, throwing, reading, custom) |
| `archived` | boolean | No | Include archived habits (default: false) |
| `limit` | number | No | Maximum results (default: 50, max: 500) · Max: 500 · Min: 1 |
| `offset` | number | No | Skip N results for pagination (default: 0) · Min: 0 |

## Example prompts

- "Show me my habits."

## Safety

**Read-only.** This tool never changes your data — it only looks things up. Safe to run anytime.