komga-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KOMGA_URL | Yes | The URL of the Komga server, e.g. https://your-komga-host. Without /api. | |
| KOMGA_API_KEY | Yes | Komga API key created in user settings. | |
| KOMGA_VERIFY_TLS | No | Whether to verify TLS certificates. Set to false when using self-signed certificates. | true |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_librariesA | List libraries visible to the authenticated Komga user. |
| get_libraryA | Get one library by ID. |
| create_libraryB | Create a library. Requires the Komga ADMIN role. |
| update_libraryB | Partially update a library. Requires the Komga ADMIN role. |
| delete_libraryA | Delete a library without deleting its files. Requires ADMIN. |
| scan_libraryC | Scan a library for new or changed files. Requires ADMIN. |
| analyze_libraryC | Analyze all books in a library. Requires ADMIN. |
| refresh_library_metadataB | Refresh embedded metadata for a library. Requires ADMIN. |
| empty_library_trashA | Permanently empty a library's trash. Requires ADMIN. |
| search_seriesD | – |
| search_series_alphabetical_groupsD | – |
| get_seriesA | Get series details and metadata by ID. |
| get_series_collectionsA | List collections containing a series. |
| get_latest_seriesC | List recently added or updated series. |
| get_new_seriesC | List newly added series. |
| get_updated_seriesA | List series that were updated but are not newly added. |
| list_series_thumbnailsA | List thumbnail metadata for a series; does not download image bytes. |
| update_series_metadataA | Update series metadata; null unsets a field and omission keeps it. Requires ADMIN. |
| refresh_series_metadataB | Re-import embedded series metadata. Requires ADMIN. |
| analyze_seriesB | Analyze all books in a series. Requires ADMIN. |
| mark_series_readB | Mark every book in a series as read. |
| mark_series_unreadB | Mark every book in a series as unread. |
| search_booksD | – |
| get_bookB | Get book details, media information, metadata, and read progress. |
| get_book_pagesA | List page metadata for a book without downloading page images. |
| get_book_nextB | Get the next book in the series. |
| get_book_previousB | Get the previous book in the series. |
| get_book_readlistsB | List readlists containing a book. |
| list_book_thumbnailsA | List thumbnail metadata for a book; does not download image bytes. |
| get_latest_booksB | List recently added or updated books. |
| get_books_ondeckB | List books currently on deck for the authenticated user. |
| get_duplicate_booksA | List duplicate books by file hash. Requires ADMIN. |
| update_book_metadataA | Update book metadata; null unsets a field and omission keeps it. Requires ADMIN. |
| update_books_metadata_bulkA | Bulk update book metadata using a map of book ID to patch. Requires ADMIN. |
| refresh_book_metadataB | Re-import embedded metadata for a book. Requires ADMIN. |
| analyze_bookC | Analyze a book. Requires ADMIN. |
| set_book_read_progressB | Set a book's read position. Supply page and/or completed. |
| mark_book_unreadB | Mark a book as unread. |
| list_collectionsB | List collections, optionally filtered by search text or library. |
| get_collectionC | Get collection details. |
| get_collection_seriesC | List series in a collection using Komga's legacy filter query params. |
| create_collectionC | Create a collection. Requires ADMIN. |
| update_collectionD | Update a collection. Requires ADMIN. |
| delete_collectionA | Delete a collection. Requires ADMIN. |
| list_readlistsA | List readlists, optionally filtered by search text or library. |
| get_readlistB | Get readlist details. |
| get_readlist_booksA | List books in a readlist using Komga's filter query params. |
| get_readlist_book_nextC | Get the next book in a readlist. |
| get_readlist_book_previousA | Get the previous book in a readlist. |
| create_readlistC | Create a readlist. Requires ADMIN. |
| update_readlistC | Update a readlist. Requires ADMIN. |
| delete_readlistA | Delete a readlist. Requires ADMIN. |
| list_authorsC | List author names and roles used by the library. |
| list_author_namesC | List distinct author names. |
| list_author_rolesC | List distinct author roles. |
| list_tagsB | List distinct tags; include can be SERIES, BOOK, or BOTH. |
| list_genresC | List distinct genres. |
| list_publishersC | List distinct publishers. |
| list_languagesC | List distinct languages. |
| list_age_ratingsB | List distinct age ratings. |
| list_sharing_labelsB | List distinct sharing labels. |
| list_series_release_yearsB | List distinct series release years. |
| whoamiA | Return the currently authenticated user. |
| list_usersB | List users. Requires ADMIN. |
| create_userB | Create a user. Requires ADMIN. |
| update_userB | Update a user. Requires ADMIN. |
| delete_userA | Delete a user. Requires ADMIN. |
| change_my_passwordB | Change the current user's password. |
| change_user_passwordA | Change another user's password. Requires ADMIN. |
| list_my_api_keysA | List API keys belonging to the current user. |
| create_api_keyC | Create an API key for the current user. |
| delete_api_keyA | Revoke one of the current user's API keys. |
| list_my_auth_activityB | List authentication activity for the current user. |
| list_auth_activityA | List all authentication activity. Requires ADMIN. |
| get_server_infoA | Get Komga build and runtime information. Requires ADMIN. |
| get_server_settingsA | Get server settings. Requires ADMIN. |
| update_server_settingsC | Update server settings. Requires ADMIN. |
| get_server_claim_statusA | Return whether the Komga server has been claimed. |
| get_server_historyC | Get server event history. Requires ADMIN. |
| clear_server_tasksA | Cancel all queued server tasks and return the number removed. Requires ADMIN. |
| list_filesystemA | List server filesystem directories for library setup. Requires ADMIN. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/SavageCore/komga-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server