Kavita MCP Connector
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP port when using HTTP transport. | 3000 |
| KAVITA_URL | Yes | Required. Self-hosted Kavita origin, http or https, no userinfo, query, or hash. Hosts on kavitareader.com and its subdomains are refused. There is no default base URL. | |
| MCP_TRANSPORT | No | Transport mode: stdio or http. --http overrides this. | |
| KAVITA_API_KEY | No | Auth Key from User Settings. Sent as the x-api-key header. Can be used instead of KAVITA_USERNAME and KAVITA_PASSWORD. | |
| KAVITA_CONTACT | No | Contact token in the User-Agent. Must not contain the key or password. | |
| KAVITA_PASSWORD | No | Password for the KAVITA_USERNAME login. The connector posts /api/Account/login once and refreshes the JWT once after a 401. | |
| KAVITA_TOOLSETS | No | Comma list of toolsets, or all. Default is the read-focused set. | |
| KAVITA_USERNAME | No | Optional login username. Set together with KAVITA_PASSWORD when no Auth Key is set. | |
| KAVITA_PER_MINUTE | No | Local request budget. Cache hits do not spend it. | 30 |
| KAVITA_TIMEOUT_MS | No | Upstream timeout in milliseconds. | 20000 |
| KAVITA_ALLOW_WRITES | No | Must be the literal true before a confirmed write is sent. The string "true" is rejected. | |
| KAVITA_CACHE_TTL_SEC | No | Read cache TTL in seconds. Writes clear the cache. | 60 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kavita_chapterA | kavita_chapter covers the chapter toolset (5 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_chapter_detail_plus, post_delete_multiple, post_update. |
| kavita_collectionA | kavita_collection covers the collection toolset (12 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_series, get_mal_stacks, get_name_exists, get_single, post_delete_multiple, post_import_stack, post_promote_multiple, post_update, post_update_for_series, post_update_series. |
| kavita_libraryA | 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. |
| kavita_metadataA | kavita_metadata covers the metadata toolset (14 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. Actions: get_age_ratings, get_all_bcp47_languages, get_all_languages, get_genres, get_language_title, get_languages, get_people, get_people_by_role, get_publication_status, get_readinglist_tags, get_series_detail_plus, get_tags, post_genres_with_counts, post_tags_with_counts. |
| kavita_personA | kavita_person covers the person toolset (10 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. Actions: get, get_chapters_by_role, get_roles, get_search, get_series_known_for, post_all, post_fetch_cover, post_merge, post_update, post_valid_alias. |
| kavita_readinglistA | 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. |
| kavita_searchA | kavita_search covers the search toolset (4 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. Actions: get_chapters_by_series, get_search, get_series_for_chapter, get_series_for_mangafile. |
| kavita_seriesA | kavita_series covers the series toolset (33 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_age_rating, get_all_related, get_chapter, get_currently_reading, get_external_series_detail, get_match_info, get_metadata, get_next_expected, get_related, get_series_by_collection, get_series_detail, get_series_with_annotations, get_volume, get_volumes, post_all_v2, post_analyze, post_delete_multiple, post_dont_match, post_match, post_metadata, post_on_deck, post_recently_added_v2, post_recently_updated_series, post_refresh_metadata, post_remove_from_on_deck, post_scan, post_series_by_ids, post_update, post_update_match, post_update_related, post_v2. |
| kavita_serverA | kavita_server covers the server toolset (17 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: get_changelog, get_check_for_updates, get_check_out_of_date, get_check_update, get_is_task_running, get_jobs, get_media_errors, get_server_info_slim, post_analyze_files, post_backup_db, post_bust_kavitaplus_cache, post_cleanup, post_cleanup_want_to_read, post_clear_cache, post_clear_media_alerts, post_convert_media, post_sync_themes. |
| kavita_statsA | kavita_stats covers the stats toolset (33 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. Actions: get_avg_time_by_hour, get_day_breakdown, get_device_client_type, get_device_device_type, get_favorite_authors, get_files_added_over_time, get_genre_breakdown, get_most_active_users, get_page_spread, get_pages_per_year, get_popular_decades, get_popular_genres, get_popular_libraries, get_popular_people, get_popular_reading_list, get_popular_series, get_popular_tags, get_reading_activity, get_reading_counts, get_reading_history, get_reading_history_series, get_reading_pace, get_reads_by_month, get_server_count_manga_format, get_server_count_publication_status, get_server_file_breakdown, get_server_stats, get_tag_breakdown, get_total_reads, get_user_read, get_user_stats, get_word_spread, get_words_per_year. |
| kavita_volumeA | kavita_volume covers the volume toolset (4 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, post_multiple, post_update. |
| kavita_wanttoreadA | kavita_wanttoread covers the wanttoread toolset (4 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. Actions: get, post_add_series, post_remove_series, post_v2. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
The 12 tools split cleanly by resource (library, series, volume, chapter, collection, readinglist, etc.), so the top-level choice is usually obvious. However, actions bleed across resources: chapter lookups appear in kavita_chapter, kavita_series (get_chapter), kavita_search (get_chapters_by_series) and kavita_readinglist, and generic actions like `get`, `delete`, and `get_name_exists` repeat in several tools with different targets. An agent must read descriptions carefully to pick the right tool for cross-cutting queries.
All 12 tool names follow a clean `kavita_<resource>` pattern, making the set easy to scan. The inconsistency is one level down: actions mix HTTP-verb prefixes (`get_`, `post_`, `delete_`), producing oddities like `delete_delete`, `post_all_v2`, and `post_delete_multiple`, which read as leaked route names rather than a deliberate verb_noun convention.
Twelve tools is squarely in the well-scoped range and maps to the natural domain entities of a self-hosted manga/comic server. The heavy lifting is pushed into per-tool `action` parameters, keeping the top-level surface small without collapsing unrelated resources into one god-tool.
Core library lifecycle is well covered: create/update/delete for library, series, volume, chapter, collection, and readinglist, plus search, metadata, people, stats, and server maintenance. Gaps exist around user/role administration, auth keys, settings, scrobbling/OAuth, and email — all referenced in the write-warning boilerplate but with no corresponding toolset — and annotation handling is read-only.