Add an entry to your AniList list
add_list_entryAdd an anime or manga to your AniList list using its media ID. Optionally specify status, score, progress, and other details.
Instructions
[Requires login] Add an anime/manga to the authenticated user's own AniList list. Use search_media first to resolve the title to its AniList media ID. Only set the fields you care about — everything else is left at AniList's defaults.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Free-text notes for this entry. | |
| score | No | Score out of 10 (decimals allowed, e.g. 8.5), always on this scale regardless of the account's configured scoreFormat (set via update_user) — no conversion needed. | |
| repeat | No | Number of times rewatched/reread. | |
| status | No | List status. If omitted, AniList defaults to CURRENT (with `startedAt` auto-set to today) — confirmed live; despite AniList's own site UI defaulting new entries to Planning, the API itself does not. | |
| mediaId | Yes | AniList anime/manga ID to add (from search_media). | |
| private | No | Hide this entry from your public list. | |
| priority | No | List priority (higher = more important). | |
| progress | No | Episodes watched / chapters read. | |
| startedAt | No | Date you started. | |
| completedAt | No | Date you completed. | |
| customLists | No | Names of custom lists to file this entry under. The list must already exist on the account (update_user's `animeListOptions`/`mangaListOptions` `customLists`) — naming one that doesn't exist yet is silently a no-op, not an error. | |
| advancedScores | No | Per-category scores, 0-10 scale (e.g. {Story: 8, Characters: 9}) — only meaningful if the account has advanced scoring enabled for this media's type. Anime and manga have SEPARATELY configured category lists, so keys must match whichever list applies to this entry. Any of that list's categories you omit here is set to 0, not left unchanged — include every category if you don't want the others zeroed. | |
| progressVolumes | No | Volumes read (manga only). | |
| hiddenFromStatusLists | No | Hide this entry from the public status-grouped list views (e.g. 'Watching') while still counting it in statistics — distinct from `private`, which hides the entry entirely. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entry | Yes |