What can you do with this server?

This MCP server allows managing and browsing a Komga digital library (comic, manga, BD, magazine, ebook) via tools exposing the Komga REST API. It provides comprehensive administration for libraries, series, books, collections, readlists, metadata, users, and server settings. * Library Management: List, get, create, update, delete, scan, analyze, refresh metadata, and empty trash for libraries. * Series Management: Search series using full-text and complex condition filters (with allOf/anyOf operators), browse alphabetically, get details/collections/thumbnails, latest/new/updated lists, update/refresh metadata, analyze, and mark read/unread. * Book Management: Search books with full-text/condition filters, get details, page metadata, next/previous in series, thumbnails, latest/ondeck/duplicates, update metadata (single/bulk), refresh/analyze, set read progress, mark unread, and list containing readlists. * Collections & Readlists: List, get, create, update, delete collections/readlists, list series in collections, books in readlists (with filtering), and navigate next/previous books in a readlist. * Referential Metadata: List authors (name and role), tags, genres, publishers, languages, age ratings, sharing labels, series release years. All support pagination, sorting, and relationship filters (by library, series, collection, readlist). * User & Authentication: Get current user (whoami), list/create/update/delete users (ADMIN), change passwords (own/other), manage API keys, and view authentication activity (own or all if ADMIN). * Server Administration: Get server info, settings, claim status, history, tasks; update settings; browse filesystem directories for library setup.

How do I use komga-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@komga-mcp find the manga series 'One Piece'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

komga-mcp

by SavageCore

Overview Schema Related Servers Score Discussions

Python

Remote

komga-mcp

Part of the arr-mcps collection. MCP server exposing Komga's REST API as tools for browsing and managing comic, manga, BD, magazine, and ebook libraries. It is built with FastMCP.

Install

Download a wheel from the latest release and install it as a uv tool:

uv tool install komga_mcp-*.whl

claude mcp add komga \
  --env KOMGA_URL=https://your-komga-host \
  --env KOMGA_API_KEY=<api-key> \
  -- komga-mcp

From source

uv sync
cp .env.example .env

claude mcp add komga \
  --env KOMGA_URL=https://your-komga-host \
  --env KOMGA_API_KEY=<api-key> \
  -- uv run --directory /path/to/komga-mcp komga-mcp

Related MCP server: access-calibre

Configuration

Komga API keys are created in the Komga user settings. The key is sent as X-API-Key on every request. The server does not accept credentials supplied by an MCP tool call.

Env var	Required	Default
`KOMGA_URL`	yes	-
`KOMGA_API_KEY`	yes	-
`KOMGA_VERIFY_TLS`	no	`true`

KOMGA_URL is the server root, without /api; the client adds the documented /api/v1 and /api/v2 paths itself. Set KOMGA_VERIFY_TLS=false only when a self-signed certificate is intentional.

Tools

The server exposes the useful JSON portions of Komga's REST API. Tools marked ADMIN require the Komga administrator role. Image, file-download, page-stream, and multipart ComicRack endpoints are intentionally excluded.

Libraries

Tool	Endpoint
`list_libraries`	`GET /api/v1/libraries`
`get_library`	`GET /api/v1/libraries/{libraryId}`
`create_library`	`POST /api/v1/libraries` (ADMIN)
`update_library`	`PATCH /api/v1/libraries/{libraryId}` (ADMIN)
`delete_library`	`DELETE /api/v1/libraries/{libraryId}` (ADMIN)
`scan_library`	`POST /api/v1/libraries/{libraryId}/scan` (ADMIN)
`analyze_library`	`POST /api/v1/libraries/{libraryId}/analyze` (ADMIN)
`refresh_library_metadata`	`POST /api/v1/libraries/{libraryId}/metadata/refresh` (ADMIN)
`empty_library_trash`	`POST /api/v1/libraries/{libraryId}/empty-trash` (ADMIN)

Series

Tool	Endpoint
`search_series`	`POST /api/v1/series/list`
`search_series_alphabetical_groups`	`POST /api/v1/series/list/alphabetical-groups`
`get_series`	`GET /api/v1/series/{seriesId}`
`get_series_collections`	`GET /api/v1/series/{seriesId}/collections`
`get_latest_series`	`GET /api/v1/series/latest`
`get_new_series`	`GET /api/v1/series/new`
`get_updated_series`	`GET /api/v1/series/updated`
`list_series_thumbnails`	`GET /api/v1/series/{seriesId}/thumbnails`
`update_series_metadata`	`PATCH /api/v1/series/{seriesId}/metadata` (ADMIN)
`refresh_series_metadata`	`POST /api/v1/series/{seriesId}/metadata/refresh` (ADMIN)
`analyze_series`	`POST /api/v1/series/{seriesId}/analyze` (ADMIN)
`mark_series_read`	`POST /api/v1/series/{seriesId}/read-progress`
`mark_series_unread`	`DELETE /api/v1/series/{seriesId}/read-progress`

Books

Tool	Endpoint
`search_books`	`POST /api/v1/books/list`
`get_book`	`GET /api/v1/books/{bookId}`
`get_book_pages`	`GET /api/v1/books/{bookId}/pages`
`get_book_next`	`GET /api/v1/books/{bookId}/next`
`get_book_previous`	`GET /api/v1/books/{bookId}/previous`
`get_book_readlists`	`GET /api/v1/books/{bookId}/readlists`
`list_book_thumbnails`	`GET /api/v1/books/{bookId}/thumbnails`
`get_latest_books`	`GET /api/v1/books/latest`
`get_books_ondeck`	`GET /api/v1/books/ondeck`
`get_duplicate_books`	`GET /api/v1/books/duplicates` (ADMIN)
`update_book_metadata`	`PATCH /api/v1/books/{bookId}/metadata` (ADMIN)
`update_books_metadata_bulk`	`PATCH /api/v1/books/metadata` (ADMIN)
`refresh_book_metadata`	`POST /api/v1/books/{bookId}/metadata/refresh` (ADMIN)
`analyze_book`	`POST /api/v1/books/{bookId}/analyze` (ADMIN)
`set_book_read_progress`	`PATCH /api/v1/books/{bookId}/read-progress`
`mark_book_unread`	`DELETE /api/v1/books/{bookId}/read-progress`

Collections and readlists

Tool	Endpoint
`list_collections`, `get_collection`, `get_collection_series`	`GET /api/v1/collections...` (the latter supports filters)
`create_collection`, `update_collection`, `delete_collection`	`POST/PATCH/DELETE /api/v1/collections...` (ADMIN)
`list_readlists`, `get_readlist`, `get_readlist_books`	`GET /api/v1/readlists...`
`get_readlist_book_next`, `get_readlist_book_previous`	`GET /api/v1/readlists/{id}/books/{bookId}/next
`create_readlist`, `update_readlist`, `delete_readlist`	`POST/PATCH/DELETE /api/v1/readlists...` (ADMIN)

Referential metadata

list_authors, list_author_names, list_author_roles, list_tags, list_genres, list_publishers, list_languages, list_age_ratings, list_sharing_labels, and list_series_release_years expose the corresponding read-only /api/v2 endpoints and accept the relevant search, relationship, pagination, and sorting filters.

Users and server

whoami, list_users, create_user, update_user, delete_user, change_my_password, change_user_password, list_my_api_keys, create_api_key, delete_api_key, list_my_auth_activity, and list_auth_activity expose user and API-key management.

get_server_info, get_server_settings, update_server_settings, get_server_claim_status, get_server_history, clear_server_tasks, and list_filesystem expose server administration and diagnostics.

Search conditions

search_series, search_books, and search_series_alphabetical_groups send a JSON body containing fullTextSearch and an optional recursive condition. Pagination is sent as query parameters (page, size, repeated sort, and unpaged). For example:

{
  "fullTextSearch": "berserk",
  "condition": {
    "allOf": [
      {"genre": {"operator": "contains", "value": "action"}},
      {"readStatus": {"operator": "is", "value": "UNREAD"}}
    ]
  }
}

Use anyOf for OR and allOf for AND. String operators include is, isNot, beginsWith, contains, endsWith, and their negative forms. Boolean fields use isTrue or isFalse; date fields use after, before, isInTheLast, isNotInTheLast, isNull, or isNotNull.

Metadata patches use Komga's normal semantics: omit a field to leave it alone, or send null to unset it. Read progress accepts page and/or completed.

Development

make help

Command	Does
`make sync`	Run `uv sync`
`make test`	Run the offline test suite
`make test-integration`	Run live tests (needs `KOMGA_URL`/`KOMGA_API_KEY`)
`make build`	Build wheel and sdist into `dist/`
`make bump-patch` / `bump-minor` / `bump-major`	Bump package version and lockfile
`make clean`	Remove build artifacts

The release workflow runs tests and publishes wheel and sdist files whenever a v* tag is pushed.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

0dRelease cycle

2Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

litellm-mcp
AI & Machine Learning Developer Tools
weeebdev
A
license
-
quality
C
maintenance
MCP server that provides tools to interact with the LiteLLM proxy API, enabling LLM completions, embeddings, image generation, and admin operations.
Updated 2 months ago (2026-06-09 20:24 UTC)
10
MIT
access-calibre
Art & Culture Search Knowledge & Memory
caplin-adam
A
license
-
quality
D
maintenance
MCP server enabling LLMs to query a local Calibre Content Server for ebook metadata, chapters, and content in HTML or Markdown.
Updated 6 months ago (2026-02-04 23:28 UTC)
15
MIT
komga-mcp
Entertainment & Media Art & Culture
pierrec18
A
license
-
quality
B
maintenance
A read-only MCP server that exposes Komga reading data via Streamable HTTP, providing tools for searching comics, listing unread series, and tracking reading progress.
Updated 4 days ago (2026-08-09 14:18 UTC)
MIT
qui-mcp
App Automation Monitoring
SavageCore
A
license
C
quality
A
maintenance
MCP server that exposes qui's JSON REST API as tools for monitoring and managing qBittorrent instances, torrents, automations, cross-seeding, RSS, backups, and related services.
Updated 10 hours ago (2026-08-12 16:35 UTC)
100
MIT

View all related MCP servers

Related MCP Connectors

server
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Backtest360
MCP server exposing the Backtest360 engine API as tools for AI agents.
Context Awesome
MCP server for accessing curated awesome list documentation

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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

komga-mcp

Install

From source

Configuration

Tools

Libraries

Series

Books

Collections and readlists

Referential metadata

Users and server

Search conditions

Development

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

litellm-mcp

access-calibre

komga-mcp

qui-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API