Komga integration
Komga is a self-hosted media server for comics, manga, BDs, magazines and EPUB books. Register the libraries it scans and trigger scans, metadata refreshes and analyses on them; browse and search series and books with their metadata, authors, genres, tags, publishers, languages, age ratings and release dates; edit that metadata one record at a time or in batches; read a book by fetching its pages, its thumbnails, its WebPub or Divina manifest, its EPUB resources or the original file; track and set read progress per book, per series and per read list; organise titles into collections and read lists, including importing a ComicRack list; manage the poster images of every kind of record; hunt duplicate pages by hash; administer users, their API keys, their passwords, their per-client settings and their authentication activity; and read server settings, task queue, history and announcements. The host is part of the credential because every install is its own deployment. Authentication is an API key sent in the X-API-Key header, or the user's email and password over HTTP Basic.
Say what should happen.
The workflow builds itself.
What you can do with Komga
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Thumbnail, 20 operations
add_user_uploaded_book_thumbnailAdd user uploaded book thumbnailPOSTAdd book poster.add_user_uploaded_collection_thumbnailAdd user uploaded collection thumbnailPOSTAdd collection poster.add_user_uploaded_read_list_thumbnailAdd user uploaded read list thumbnailPOSTAdd readlist poster.add_user_uploaded_series_thumbnailAdd user uploaded series thumbnailPOSTAdd series poster.books_regenerate_thumbnailsBooks regenerate thumbnailsPUTRegenerate books posters.delete_user_uploaded_book_thumbnailDelete user uploaded book thumbnailDELETEDelete book poster.delete_user_uploaded_collection_thumbnailDelete user uploaded collection thumbnailDELETEDelete collection poster.delete_user_uploaded_read_list_thumbnailDelete user uploaded read list thumbnailDELETEDelete readlist poster.delete_user_uploaded_series_thumbnailDelete user uploaded series thumbnailDELETEDelete series poster.get_book_page_thumbnail_by_numberGet book page thumbnail by numberGETGet book page thumbnail.get_book_thumbnailGet book thumbnailGETGet book's poster image.get_book_thumbnail_by_idGet book thumbnail by idGETGet book poster image.get_book_thumbnailsGet book thumbnailsGETList book posters.get_collection_thumbnailGet collection thumbnailGETGet collection's poster image.get_collection_thumbnail_by_idGet collection thumbnail by idGETGet collection poster image.get_collection_thumbnailsGet collection thumbnailsGETList collection's posters.get_known_page_hash_thumbnailGet known page hash thumbnailGETGet known duplicate image thumbnail.get_read_list_thumbnailGet read list thumbnailGETGet readlist's poster image.get_read_list_thumbnail_by_idGet read list thumbnail by idGETGet readlist poster image.get_read_list_thumbnailsGet read list thumbnailsGETList readlist's posters.
Book, 5 operations
get_all_books_deprecatedGet all books deprecatedGETList books.get_book_by_idGet book by idGETGet book details.get_books_by_read_list_idGet books by read list idGETList readlist's books.get_books_by_series_idGet books by series idGETList series' books.get_book_tagsGet book tagsGETList book tags.
Collection, 5 operations
create_collectionCreate collectionPOSTCreate collection.delete_collection_by_idDelete collection by idDELETEDelete collection.get_collection_by_idGet collection by idGETGet collection details.get_collectionsGet collectionsGETList collections.get_collections_by_series_idGet collections by series idGETList series' collections.
File, 5 operations
delete_book_fileDelete book fileDELETEDelete book file.delete_series_fileDelete series fileDELETEDelete series files.download_book_fileDownload book fileGETDownload book file.download_read_list_as_zipDownload read list as zipGETDownload readlist.download_series_as_zipDownload series as zipGETDownload series.
Readlist, 5 operations
create_read_listCreate read listPOSTCreate readlist.delete_read_list_by_idDelete read list by idDELETEDelete readlist.get_read_list_by_idGet read list by idGETGet readlist details.get_read_listsGet read listsGETList readlists.get_read_lists_by_book_idGet read lists by book idGETList book's readlists.
Librarie, 4 operations
add_libraryAdd libraryPOSTCreate a library.delete_library_by_idDelete library by idDELETEDelete a library.get_librariesGet librariesGETList all libraries.get_library_by_idGet library by idGETGet details for a single library.
Api key, 3 operations
create_api_key_for_current_userCreate api key for current userPOSTCreate API key.delete_api_key_by_key_idDelete api key by key idDELETEDelete API key.get_api_keys_for_current_userGet api keys for current userGETRetrieve API keys.
Latest, 3 operations
get_books_latestGet books latestGETList latest books.get_latest_authentication_activity_by_user_idGet latest authentication activity by user idGETRetrieve latest authentication activity for a user.get_series_latestGet series latestGETList latest series.
List, 3 operations
get_booksGet booksPOSTList books.get_global_settingsGet global settingsGETRetrieve global client settings.get_seriesGet seriesPOSTList series.
Page, 3 operations
get_book_page_by_numberGet book page by numberGETGet book page image.get_book_pagesGet book pagesGETList book pages.get_page_by_transient_book_idGet page by transient book idGETGet transient book page.
Page hashe, 3 operations
create_or_update_known_page_hashCreate or update known page hashPUTMark duplicate page as known.get_known_page_hashesGet known page hashesGETList known duplicates.get_page_hash_matchesGet page hash matchesGETList duplicate matches.
Serie, 3 operations
get_series_by_collection_idGet series by collection idGETList collection's series.get_series_by_idGet series by idGETGet series details.get_series_deprecatedGet series deprecatedGETList series.
User, 3 operations
add_userAdd userPOSTCreate user.delete_user_by_idDelete user by idDELETEDelete user.delete_user_settingsDelete user settingsDELETEDelete user settings.
Age rating, 2 operations
get_age_ratingsGet age ratingsGETList age ratings.get_age_ratings_v1Get age ratings v1GETList age ratings.
Alphabetical group, 2 operations
get_series_alphabetical_groupsGet series alphabetical groupsPOSTList series groups.get_series_alphabetical_groups_deprecatedGet series alphabetical groups deprecatedGETList series groups.
Analyze, 2 operations
analyze_transient_bookAnalyze transient bookPOSTAnalyze transient book.book_analyzeBook analyzePOSTAnalyze book.
Authentication activity, 2 operations
get_authentication_activityGet authentication activityGETRetrieve authentication activity.get_authentication_activity_for_current_userGet authentication activity for current userGETRetrieve authentication activity for the current user.
Author, 2 operations
get_authorsGet authorsGETList authors.get_authors_deprecatedGet authors deprecatedGETList authors.
Claim, 2 operations
claim_serverClaim serverPOSTClaim server.get_claim_statusGet claim statusGETRetrieve claim status.
Genre, 2 operations
get_genresGet genresGETList genres.get_genres_v1Get genres v1GETList genres.
Language, 2 operations
get_languagesGet languagesGETList languages.get_languages_v1Get languages v1GETList languages.
Me, 2 operations
delete_sync_points_for_current_userDelete sync points for current userDELETEDelete all sync points.get_current_userGet current userGETRetrieve current user.
Name, 2 operations
get_authors_namesGet authors namesGETList authors names.get_authors_names_v1Get authors names v1GETList authors' names.
Next, 2 operations
get_book_sibling_nextGet book sibling nextGETGet next book in series.get_book_sibling_next_in_read_listGet book sibling next in read listGETGet next book in readlist.
Previou, 2 operations
get_book_sibling_previousGet book sibling previousGETGet previous book in series.get_book_sibling_previous_in_read_listGet book sibling previous in read listGETGet previous book in readlist.
Publisher, 2 operations
get_publishersGet publishersGETList publishers.get_publishers_v1Get publishers v1GETList publishers.
Resource, 2 operations
get_book_epub_resourceGet book epub resourceGETGet Epub resource.get_font_fileGet font fileGETDownload font file.
Role, 2 operations
get_authors_rolesGet authors rolesGETList authors roles.get_authors_roles_v1Get authors roles v1GETList authors' roles.
Tachiyomi, 2 operations
get_mihon_read_progress_by_read_list_idGet mihon read progress by read list idGETGet readlist read progress (Mihon).get_mihon_read_progress_by_series_idGet mihon read progress by series idGETGet series read progress (Mihon).
Announcement, 1 operation
get_announcementsGet announcementsGETRetrieve announcements.
Delete all, 1 operation
delete_duplicate_pages_by_page_hashDelete duplicate pages by page hashPOSTDelete all duplicate pages by hash.
Delete match, 1 operation
delete_single_match_by_page_hashDelete single match by page hashPOSTDelete specific duplicate page.
Divina, 1 operation
get_book_web_pub_manifest_divinaGet book web pub manifest divinaGETGet book's WebPub manifest (DiViNa).
Duplicate, 1 operation
get_books_duplicatesGet books duplicatesGETList duplicate books.
Epub, 1 operation
get_book_web_pub_manifest_epubGet book web pub manifest epubGETGet book's WebPub manifest (Epub).
Familie, 1 operation
get_fontsGet fontsGETList font families.
Filesystem, 1 operation
get_directory_listingGet directory listingPOSTDirectory listing.
Global, 1 operation
delete_global_settingsDelete global settingsDELETEDelete global settings.
History, 1 operation
get_historical_eventsGet historical eventsGETList historical events.
Info, 1 operation
get_actuator_infoGet actuator infoGETGet server information.
Manifest, 1 operation
get_book_web_pub_manifestGet book web pub manifestGETGet book's WebPub manifest.
New, 1 operation
get_series_newGet series newGETList new series.
Ondeck, 1 operation
get_books_on_deckGet books on deckGETList books on deck.
Pdf, 1 operation
get_book_web_pub_manifest_pdfGet book web pub manifest pdfGETGet book's WebPub manifest (PDF).
Position, 1 operation
get_book_positionsGet book positionsGETList book's positions.
Progression, 1 operation
get_book_progressionGet book progressionGETGet book progression.
Raw, 1 operation
get_book_page_raw_by_numberGet book page raw by numberGETGet raw book page.
Read progres, 1 operation
delete_book_read_progressDelete book read progressDELETEMark book as unread.
Refresh, 1 operation
book_refresh_metadataBook refresh metadataPOSTRefresh book metadata.
Release, 1 operation
get_releasesGet releasesGETList releases.
Release date, 1 operation
get_series_release_datesGet series release datesGETList series release dates.
Task, 1 operation
empty_task_queueEmpty task queueDELETEClear task queue.
Showing the first 120 of 164 endpoints. The rest are in the product, searchable from the workflow builder and from chat.
Use Komga from Claude Code, Cursor or Codex
Connect Komga in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Komga operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Komga
- Create your workspace
Sign up free. Nothing to install.
- Connect Komga once
Add your Komga connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Komga integration FAQ
What can you do with the Komga integration?
LiveContext exposes 164 operations on Komga, covering thumbnail, book, collection and file.
