Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
KOMGA_URLYesThe URL of the Komga server, e.g. https://your-komga-host. Without /api.
KOMGA_API_KEYYesKomga API key created in user settings.
KOMGA_VERIFY_TLSNoWhether to verify TLS certificates. Set to false when using self-signed certificates.true

Capabilities

Features and capabilities supported by this server

CapabilityDetails
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

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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