kavita_library
Manage self-hosted Kavita libraries by listing, creating, updating, scanning, refreshing metadata, granting access, and deleting, with dry-run previews and explicit confirmation for writes.
Instructions
kavita_library covers the library toolset (23 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_delete, delete_delete_multiple, get, get_jump_bar, get_libraries, get_list, get_metadata_enabled_libraries, get_metadata_providers, get_name_exists, get_scrobble_enabled_libraries, get_type, get_user_libraries, post_copy_settings_from, post_create, post_grant_access, post_has_files_at_root, post_refresh_metadata, post_refresh_metadata_multiple, post_scan, post_scan_all, post_scan_folder, post_scan_multiple, post_update.
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_library"
}
}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. |