Bot Essentials
SupportSign in

MCP connector · Reading

Komga

Browse your Komga comics and manga library.

  • 34 tools
  • 51 tests passing
  • MIT licence
  • Free and open

InstallStar on GitHubSupport the project

See it work

Example. A real tool and its real input. No live data is shown here.

You ask
“List the series in my Komga library.”
Your bot calls
komga_series with action plus optional query
It gets back
Series from your own Komga.

Install

git clone https://github.com/si-essence/komga-mcp.git && cd komga-mcp && npm install && npm run build

Needs Node.js. Then add the built server to your MCP client. Install guide

Facts

Tools
34
Tests
51 passing
Licence
MIT
Source
github.com/si-essence/komga-mcp
Listing updated
31 October 2026
Last code push
31 October 2026
Maintained by
Bot Essentials

Tests were run on 27 October 2026 in a clean copy of each connector. You bring your own keys for any service it talks to.

Details and limits

Komga is a local MCP server for a self-hosted Komga comics, manga and ebook server. The package name is komga-mcp. You run it over stdio or stateless Streamable HTTP on localhost. It does not start Komga for you. This is free; the catalogue price is Free.

Works with Komga. Not affiliated with or endorsed by the Komga project.

There is no hosted service in this listing. Create an API key in Komga under User settings. Set KOMGA_URL to your server and KOMGA_API_KEY to the key, sent as the X-API-Key header. KOMGA_USERNAME and KOMGA_PASSWORD (HTTP basic auth) also work. Keys and passwords are never printed.

Writes are confirm-gated. A write is a dry-run preview when confirm is omitted. confirm must be the boolean true, and KOMGA_ALLOW_WRITES must be the literal true.

The default KOMGA_TOOLSETS publishes 7 read-focused tools. Set it to all for 34 tools. Each tool takes an action field. The 22 endpoints that return files, images, page bytes, font bytes or multipart uploads are left out.

The local limit defaults to 30 requests a minute. A cache hit does not spend that window.

Checked live against a real Komga 1.29.2 server: 16 checks passed. Other operations are covered by mock-server tests only.

Komga is MIT. The connector is MIT and only calls the public HTTP API.

Tools

34 tools.

  • komga_libraries

    Libraries: 9 operations (default)

  • komga_series

    Series: 16 operations (default)

  • komga_books

    Books: 16 operations (default)

  • komga_collections

    Collections: 5 operations (default)

  • komga_readlists

    Readlists: 5 operations (default)

  • komga_referential_metadata

    Referential metadata: 13 operations (default)

  • komga_management

    Management: 1 operation (default)

  • komga_announcements

    Announcements: 2 operations

  • komga_api_keys

    Api keys: 3 operations

  • komga_book_pages

    Book pages: 1 operation

  • komga_book_poster

    Book poster: 5 operations

  • komga_claim

    Claim: 2 operations

  • komga_client_settings

    Client settings: 6 operations

  • komga_collection_poster

    Collection poster: 4 operations

  • komga_collection_series

    Collection series: 1 operation

  • komga_current_user

    Current user: 3 operations

  • komga_deprecated

    Deprecated: 13 operations

  • komga_duplicate_pages

    Duplicate pages: 6 operations

  • komga_file_system

    File system: 1 operation

  • komga_fonts

    Fonts: 1 operation

  • komga_history

    History: 1 operation

  • komga_import

    Import: 3 operations

  • komga_mihon

    Mihon: 4 operations

  • komga_oauth2

    Oauth2: 1 operation

  • komga_readlist_books

    Readlist books: 3 operations

  • komga_readlist_poster

    Readlist poster: 4 operations

  • komga_releases

    Releases: 1 operation

  • komga_series_poster

    Series poster: 4 operations

  • komga_server_settings

    Server settings: 2 operations

  • komga_sync_points

    Sync points: 1 operation

  • komga_tasks

    Tasks: 1 operation

  • komga_user_session

    User session: 3 operations

  • komga_users

    Users: 7 operations

  • komga_web_pub_manifest

    Web pub manifest: 7 operations