kavita_readinglist
Manage Kavita reading lists and reading progress: create, update, delete lists, add or remove items, export CBL, and track next/previous chapters via MCP operations.
Instructions
kavita_readinglist covers the readinglist toolset (27 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KAVITA_ALLOW_WRITES=true. Omit confirm for a dry-run preview that sends nothing. Destructive, credential, or exposure actions add an extra warning in the preview and here: delete, scan, analyze, refresh, cache clear, cleanup, user or role changes, Auth Key create or revoke, password reset, settings, license, scrobbling tokens, OAuth or OIDC, and email. Actions: delete, get, get_all_people, get_info, get_items, get_lists_for_chapter, get_lists_for_series, get_name_exists, get_next_chapter, get_people, get_prev_chapter, post_all, post_create, post_delete_item, post_delete_multiple, post_export_as_cbl, post_lists, post_promote_multiple, post_regenerate_cover, post_remove_read, post_update, post_update_by_chapter, post_update_by_multiple, post_update_by_multiple_series, post_update_by_series, post_update_by_volume, post_update_position.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "kavita_readinglist"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | JSON body for the Kavita operation. Secrets are redacted in output. | |
| query | No | OpenAPI query parameters. | |
| action | Yes | Kavita operation to call, or help. | |
| params | No | OpenAPI path parameters, such as seriesId. | |
| target | No | With action help, the action whose parameters to describe. | |
| confirm | No | Set to the boolean true to execute the write. Omit this field for a dry-run preview. false and the string true are rejected. |