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 |
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
} |
| 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/arr-mcps/komga-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server