komga
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP port. Default 3000. | 3000 |
| KOMGA_URL | No | Required. Self-hosted origin, http or https, no userinfo, query, or hash. Example http://127.0.0.1:25600. | |
| KOMGA_API_KEY | No | API key from User settings. Sent as the X-API-Key header. | |
| KOMGA_CONTACT | No | Contact token in the User-Agent. Must not contain a secret. | |
| MCP_TRANSPORT | No | stdio or http. --http overrides. | |
| KOMGA_PASSWORD | No | Password for that login. Sent as HTTP basic auth. Redacted everywhere. | |
| KOMGA_TOOLSETS | No | Comma list of toolsets, or all. Default is the read-focused set. | |
| KOMGA_USERNAME | No | Optional login, usually the account email. Set together with KOMGA_PASSWORD when no API key is set. | |
| KOMGA_PER_MINUTE | No | Local request budget. Default 30. Cache hits do not spend it. | 30 |
| KOMGA_TIMEOUT_MS | No | Upstream timeout. Default 20000. | 20000 |
| KOMGA_ALLOW_WRITES | No | Must be the literal true before a confirmed write is sent. | |
| KOMGA_CACHE_TTL_SEC | No | Read cache TTL. Default 60. 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 |
|---|---|
| komga_booksA | komga_books covers the books toolset (16 operations). Auth is the X-API-Key header, or HTTP basic auth from KOMGA_USERNAME and KOMGA_PASSWORD. Self-hosted Komga only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KOMGA_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, trash empty, user or role changes, API key create or revoke, password change, settings, session, and claim. Actions: delete_file, delete_read_progress, get, get_book_id, get_duplicates, get_latest, get_next, get_ondeck, get_previous, get_readlists, patch_metadata, patch_metadata_book_id, patch_read_progress, post_analyze, post_list, post_metadata_refresh. |
| komga_collectionsA | komga_collections covers the collections toolset (5 operations). Auth is the X-API-Key header, or HTTP basic auth from KOMGA_USERNAME and KOMGA_PASSWORD. Self-hosted Komga only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KOMGA_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, trash empty, user or role changes, API key create or revoke, password change, settings, session, and claim. Actions: delete, get, get_id, patch, post. |
| komga_librariesA | komga_libraries covers the libraries toolset (9 operations). Auth is the X-API-Key header, or HTTP basic auth from KOMGA_USERNAME and KOMGA_PASSWORD. Self-hosted Komga only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KOMGA_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, trash empty, user or role changes, API key create or revoke, password change, settings, session, and claim. Actions: delete, get, get_library_id, patch, post, post_analyze, post_empty_trash, post_metadata_refresh, post_scan. |
| komga_managementB | komga_management covers the management toolset (1 operations). Auth is the X-API-Key header, or HTTP basic auth from KOMGA_USERNAME and KOMGA_PASSWORD. Self-hosted Komga only. action help with target returns one action's parameters. Actions: get_actuator_info. |
| komga_readlistsB | komga_readlists covers the readlists toolset (5 operations). Auth is the X-API-Key header, or HTTP basic auth from KOMGA_USERNAME and KOMGA_PASSWORD. Self-hosted Komga only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KOMGA_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, trash empty, user or role changes, API key create or revoke, password change, settings, session, and claim. Actions: delete, get, get_id, patch, post. |
| komga_referential_metadataA | komga_referential_metadata covers the referential_metadata toolset (13 operations). Auth is the X-API-Key header, or HTTP basic auth from KOMGA_USERNAME and KOMGA_PASSWORD. Self-hosted Komga only. action help with target returns one action's parameters. Actions: get_age_ratings, get_authors, get_authors_names, get_authors_roles, get_genres, get_languages, get_notable_entities, get_notable_entities_kinds, get_notable_entities_names, get_publishers, get_series_release_years, get_sharing_labels, get_tags. |
| komga_seriesA | komga_series covers the series toolset (16 operations). Auth is the X-API-Key header, or HTTP basic auth from KOMGA_USERNAME and KOMGA_PASSWORD. Self-hosted Komga only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KOMGA_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, trash empty, user or role changes, API key create or revoke, password change, settings, session, and claim. Actions: delete_file, delete_read_progress, get, get_alphabetical_groups, get_books, get_collections, get_latest, get_new, get_series_id, get_updated, patch_metadata, post_analyze, post_list, post_list_alphabetical_groups, post_metadata_refresh, post_read_progress. |
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 7 tools
Tools are split cleanly by Komga resource (books, series, collections, readlists, libraries, referential metadata, management), so the main boundaries are clear. However, collections and readlists have almost identical action shapes, and books/series both expose overlapping read-progress and listing actions, which could cause occasional misselection.
Every tool follows the same komga_<resource> snake_case convention, with plural resource names except for the clearly named referential_metadata and management sets. There is no mixing of camelCase or inconsistent verb/noun patterns at the tool level.
Seven tools is a reasonable scoping for a Komga server and keeps the top-level surface manageable. The only slight imbalance is komga_management, which contains a single actuator-info operation and feels underfilled compared with the other resource toolsets.
Core library management coverage is strong: books, series, collections, readlists, and libraries all support relevant read/write/lifecycle operations. There are still notable gaps around administrative surfaces mentioned in the warnings—users, roles, API keys, sessions, settings, password changes, and claims—which have no corresponding toolset.