Skip to main content
Glama

Infinite Backlog MCP

Infinite Backlog MCP

An MCP server that lets an AI assistant manage your Infinite Backlog account.

Python 3.11+ License: MIT MCP Listed on mcpservers.org

Goals

  • Let your assistant read and update your Infinite Backlog collection without you clicking through the site.

  • Use the same calls the website makes, so the results match what you see in your account.

  • Stay safe by default: nothing deletes, publishes or posts unless you ask for it.

Built for Infinite Backlog v2.1.0. This is an unofficial project, not affiliated with Infinite Backlog. It uses the site's private API, which can change without notice. Check Infinite Backlog's terms before heavy use.

Related MCP server: CloakBrowser MCP

What it can do

  • Catalog: search games, game info, community stats, DLC and editions, achievements and trophies.

  • Collection: add games and platform copies, set status, progress, playtime, notes, details and acquisition.

  • Ratings and reviews: overall and sub-ratings, reviews saved as drafts or published.

  • Play records: your own notes and checklists per copy (key/values, checklists, progress bars, tables, text).

  • Playthroughs and sessions: log playthroughs and play sessions, read your play journal.

  • Tags: custom tags on your copies.

  • Wishlist and lists: manage your wishlist and your custom lists.

  • Playtime: submit time to beat and time to complete, and read what you submitted.

  • Stats: your collection, activity and yearly stats.

What it can't do

  • Read or click through web pages. Every tool uses the site's API.

  • Change your profile, settings, widgets, friends or feed.

  • Post to the community feed.

  • Publish a list or submit playtimes unless you ask for it.

  • Sign in past a captcha or second factor. You finish those by hand (browser mode) or switch modes.

  • Call any API endpoint that isn't on its allowlist, or open any site other than infinitebacklog.net.

Installation

  1. Install Python 3.11 or newer.

  2. Set up the server:

    cd infinitebacklog-mcp
    python -m venv .venv
    .venv\Scripts\activate
    pip install -e .
    python -m playwright install chromium   # only for the bundled browser option
  3. Copy .env.example to .env and fill in IB_USERNAME (username or email) and IB_PASSWORD. The login tool uses them. HTTP mode needs them. In a browser mode you can sign in by hand instead. Never commit .env.

  4. Add the server to your MCP client:

    {
      "mcpServers": {
        "infinitebacklog": {
          "command": "C:/path/to/infinitebacklog-mcp/.venv/Scripts/python.exe",
          "args": ["-m", "infinitebacklog_mcp.server"],
          "cwd": "C:/path/to/infinitebacklog-mcp"
        }
      }
    }

    After pip install -e . you can use "command": "infinitebacklog-mcp" instead. Logs go to stderr.

  5. Start your MCP client. The first tool call asks which sign-in mode to use. You can also call choose_browser yourself.

  6. Sign in once. In a browser mode, the server signs in with .env when the browser first opens, or you can call login, or sign in by hand in the window. In HTTP mode, the server signs in with .env on the first call. Nothing opens.

  7. Try search_games and list_collection.

Sign-in modes

Nothing signs in or opens until you choose a mode. The choice lasts until the server stops and is never written to disk. To skip the question, set IB_BROWSER.

Browser modes. A window opens. Sign in there by hand, or let the server fill in IB_USERNAME and IB_PASSWORD. The session is saved in the server's profile folder and reused. The window stays visible, because Infinite Backlog renders blank in headless browsers. The options:

  • a Chromium-based browser that is your system default or currently open, started with the server's own private profile

  • Playwright's bundled Chromium, also with a private profile

  • an already-open browser with a local debug port (--remote-debugging-port=9222, or IB_CDP_URL). This uses that browser's real profile and opens one new tab. You opt in to this one.

  • any other Chromium-based browser you point to by path

Firefox and Safari can't be driven this way. Pick the bundled Chromium if one of them is your default. The server never reads cookies or profile data from your everyday browser.

HTTP mode. No browser. The server signs in through Infinite Backlog's own login form over HTTPS, with the standard authorization code and PKCE flow, then refreshes the token as needed. It identifies itself as infinitebacklog-mcp. It solves no captchas. If the login asks for a captcha or 2FA, it stops with browser_sign_in_required, and you switch to a browser mode. In HTTP mode, open_site and current_url don't apply.

Browser mode

HTTP mode

Needs a browser

Yes

No

Sign in by hand

Yes

No

Needs IB_USERNAME and IB_PASSWORD in .env

Optional

Yes

Captcha or 2FA

Yes, by hand in the window

No, the server stops and asks you to switch

Neither mode writes tokens to disk. The password is never logged or returned.

Supported tools

Games are identified by their slug from search_games. You can own a game more than once, one copy per platform. Progress, acquisition, DLC, tags, play records and playthroughs belong to a copy. Ratings and reviews belong to the game. When a game has several copies, pass collection_id (shown by list_collection_game_options).

Anything that deletes needs confirm=true.

Catalog and game info

Tool

What it does

search_games

Search the catalog. Returns name, slug, year, type.

get_game

Summary, platforms, developers, scores, average playtimes, and your status for that game.

list_related_content

DLC, expansions, packs and add-ons, editions, bundles, remakes.

get_game_stats

Community numbers: owners per status and completion, wishlists, rating distribution.

list_achievements

Achievement and trophy sets (Steam, PlayStation, Xbox, GOG, RetroAchievements) with your progress. include_list=true lists every achievement.

Your collection

Tool

What it does

list_collection

Your games, filterable by status or title.

list_collection_game_options

Everything about your copies of one game.

add_game_to_collection

Add a game on a platform, physical or digital, with a starting status.

add_game_platform_copy

Add another copy on a different platform.

set_game_progress

Status, completion, progress bar (0-100), notes, playtime and playtime type, times finished, completion date.

set_game_details

Platform, ownership, digital or physical, region, edition, lent to or borrowed from.

set_game_acquisition

How and where you got it, date, price, notes, digital store, and condition for physical copies.

delete_game_copy

Remove one copy.

DLC and add-ons

Tool

What it does

list_collection_content_menus

DLC and packs attached to a copy, and the ones you can still add.

add_game_content

Attach DLC, expansions, packs or add-ons by name (or IGDB id). Already-owned items are skipped.

remove_game_content

Detach them again.

Ratings and reviews

Tool

What it does

set_game_rating

Overall 1-10, plus Gameplay, Story, Visual, Audio and Playability. clear=true removes it.

add_game_review

Write or edit a review. A draft unless publish=true (needs 800+ characters and a score).

delete_game_review

Delete it. A published review also needs published=true.

Play records

Play records are your own notes and checklists for a copy, grouped in categories. Five types:

  • keyValue: name and value ("Final boss" / "Beaten")

  • checkbox: a checklist, with optional earned dates (good for tracking achievements by hand)

  • progress: earned / total, with an optional description

  • table: rows of columns

  • text: one free-text note

Tool

What it does

list_play_records

All categories and rows, numbered from 1.

set_play_record_category

Add, nest, rename or restyle a category.

set_play_record

Add a row, or update one by number or name.

remove_play_record

Remove a row, or a whole category.

copy_play_records

Copy one copy's play records to another copy of the same game. The target must have none yet.

share_play_records

Share with another copy of the same game (share=true), or stop sharing (share=false).

Playthroughs and sessions

Tool

What it does

list_playthroughs

Playthroughs of a copy with their sessions.

set_playthrough

Create or edit one: name, type, difficulty, notes, playtime. extra_hours and extra_minutes add time on top.

remove_playthrough

Delete a playthrough and its sessions.

add_play_session

Log a session: date, time played, status, notes. Pass session_id to edit one.

remove_play_session

Delete a session.

get_play_journal

Your latest sessions across all games.

Tags and stats

Tool

What it does

list_custom_tags

Your custom tags.

set_game_tags

Add or remove tags on a copy. Creating new tags needs an Infinite Backlog supporter account (otherwise feature_locked).

delete_custom_tag

Remove a tag from your library.

get_user_stats

Collection, activity, achievement and rating stats, plus a yearly or monthly recap.

Wishlist

Tool

What it does

list_wishlist

Your wishlist, with notes, pre-order and favourite flags.

add_to_wishlist

Add a game, or update one already on the list (notes, preorder).

remove_from_wishlist

Remove a game. Needs confirm=true.

Custom lists

Lists are public once published, so they stay drafts unless you pass publish=true. Only your own lists can be changed or deleted.

Tool

What it does

list_my_lists

Your lists: title, published flag, number of games, last update.

get_list

One list with its games in order.

create_list

New list from comma-separated game slugs.

update_list

Change title, description, add_games, remove_games, ranked or publish.

delete_list

Delete one of your lists. Needs confirm=true.

Playtime contributions

Submitted times go to Infinite Backlog's public playtime data. There is no delete. Submitting again replaces your figures.

Tool

What it does

list_playtime_contributions

The playtime figures you have submitted, newest first.

submit_playtime

Submit time to beat and time to complete. Needs a copy marked Beaten or Completed, and confirm=true.

Session

Tool

What it does

choose_browser

List the sign-in options, or record the one you picked (including HTTP mode).

login

Sign in with .env credentials. Works in browser modes and HTTP mode.

open_site, current_url, close_browser

Browser modes only. Open a page in the server's window, show where it is, close it.

Settings

Variable

Default

Purpose

IB_USERNAME, IB_PASSWORD

empty

Sign-in for login and HTTP mode. Keep them out of git.

IB_BROWSER

empty (ask)

Pre-approve a sign-in mode: bundled, default, attach or http.

IB_BROWSER_PATH

empty

Pre-approve a specific Chromium-based browser by path.

IB_CDP_URL

http://127.0.0.1:9222

Local debug endpoint for the attach option. Only localhost is accepted.

IB_HEADLESS

false

Leave it off: the site renders blank headless. Browser modes only.

IB_VIEWPORT_WIDTH, IB_VIEWPORT_HEIGHT

1280 x 800

Window size. Browser modes only.

IB_CHROMIUM_NO_SANDBOX

false

Containers only.

Supported Platforms

Windows only for now. Other systems are untested. The code is written for them, so reports are welcome.

More

  • docs/api-v2.md: the endpoints and payloads this server uses. If Infinite Backlog changes its API, start there.

  • AGENTS.md: notes for assistants calling the tools.

  • CHANGELOG.md: what changed in each release.

License

MIT. See LICENSE.

Available Tools

50 tools
add_game_contentA

Attach DLC, expansions, packs or add-ons to a copy you own. names: one title, a JSON array, or one title per line (game ids also work). Matches against the game's related content; already-attached items are skipped. completion (DLC only) sets their completion. platform/digital are ignored (they belong to the parent copy).

Inputs: names (required), parent_slug (required), digital, wait_ms, +3 more. Returns: result

add_game_platform_copyA

Add another copy of a game you already own, on another platform (its own progress, acquisition and play records).

Inputs: slug (required), platform (required), submit, digital. Returns: result

add_game_reviewA

Write or update your review. Saved as a draft unless publish=true. Publishing needs 800+ characters of text and an overall score (1-10). body is plain text (blank lines split paragraphs) or HTML. title 5-100 chars. pros/cons: JSON array or one per line. Re-running edits the same review.

Inputs: body (required), slug (required), cons, pros, +10 more. Returns: result

add_game_to_collectionA

Add a game to your collection (one copy on one platform). Refuses a second copy on the same platform unless allow_duplicate=true. For another platform use add_game_platform_copy.

Inputs: slug (required), status, digital, platform, +1 more. Returns: result

add_play_sessionA

Log a play session (date YYYY-MM-DD, hours/minutes played, status, notes) on a playthrough of one copy. Pass session_id to edit an existing session instead. status: start, playing, campaignCompleted (beaten), completed, shelved, dropped. Sessions are capped at 24h each.

Inputs: date (required), slug (required), hours, notes, +5 more. Returns: result

add_to_wishlistA

Add a game to your wishlist. Optional notes and preorder ("true"/"false"; empty keeps the current value), applied also when the game is already on it.

Inputs: slug (required), notes, preorder. Returns: result

choose_browserA

Pick the browser this server may use. Call it without arguments to list the options, then pass the id the USER picked; never choose for them.

Options: an already-open browser with a local debug port (uses its real profile, one new tab), a detected Chromium-based browser started with this server's private profile, Playwright's bundled Chromium, or "other" with the path of another Chromium-based browser. Changing the choice closes the current session first. Nothing opens until the next tool call.

Inputs: path, choice. Returns: result

close_browserA

Close this server's window. A browser it attached to keeps running; only its own tab closes.

Inputs: no named parameters. Returns: result

copy_play_recordsA

Copy the Play Records of one copy to another copy of the same game. The target must have no Play Records yet.

Inputs: slug (required), to_collection_id (required), from_collection_id (required). Returns: result

create_listB

Create a custom game list. games: comma-separated game slugs or a JSON array. Saved as a draft unless publish=true (public).

Inputs: title (required), games, ranked, publish, +3 more. Returns: result

current_urlA

Return the current URL, the page title and which browser is in use.

Inputs: no named parameters. Returns: result

delete_custom_tagA

Delete a custom tag from your tag library (it disappears from every game). Needs confirm=true.

Inputs: name (required), confirm. Returns: result

delete_game_copyB

Delete one copy from your collection, with its progress, acquisition and play records link. Needs collection_id and confirm=true.

Inputs: slug (required), confirm, collection_id. Returns: result

delete_game_reviewA

Delete your review of a game. Drafts need confirm=true. A published review also needs published=true, so it is never removed by accident.

Inputs: slug (required), confirm, published. Returns: result

delete_listB

Delete one of your custom lists. Needs confirm=true.

Inputs: list_id (required), confirm. Returns: result

get_gameC

Game details: summary, platforms, genres, developers, playtime averages, IB and critic scores, and your own collection/rating/wishlist state when signed in.

Inputs: slug (required), full. Returns: result

get_game_statsB

Community stats for a game: owners by status and completion, wishlist count, playtime averages, and rating distribution.

Inputs: slug (required). Returns: result

get_listB

Read one custom list: title, description, published and ranked flags, and its games in order. Read-only.

Inputs: list_id (required). Returns: result

get_play_journalB

Your recent play sessions across all games (the IB journal), newest first.

Inputs: limit, offset. Returns: result

get_user_statsA

Collection, activity, achievement and rating statistics for you (default) or another public profile. year (and optional month) adds that period's recap.

Inputs: year, month, username. Returns: result

list_achievementsA

Achievements and trophies.

With slug: every achievement set for that game (Steam, PlayStation, Xbox, GOG, RetroAchievements) with your earned count when signed in. include_list=true also returns each achievement (name, description, unlocked state when synced). Without slug: your synced achievement games, newest first. Achievements come from linked store accounts. To track them by hand, use a checkbox Play Records category (set_play_record_category type=checkbox).

Inputs: slug, limit, max_per_set, include_list. Returns: result

list_collectionC

List your collection. Filter by status (unplayed/playing/played/noStatus) or a title search.

Inputs: sort, limit, order, offset, +2 more. Returns: result

list_collection_content_menusB

For one copy: DLC/expansions and packs/add-ons you already attached, and the ones you can still add. Read-only. (edit_path is accepted for v1 callers: /users/{u}/collection/{slug}/edit?id=N.)

Inputs: slug, edit_path, collection_id. Returns: result

list_collection_game_optionsB

Everything about your copies of one game: per-copy details, progress, acquisition, tags, DLC, play records id, playthroughs, your rating and your review. Read-only.

Inputs: slug (required), wait_ms, collection_id. Returns: result

list_custom_tagsB

List your custom collection tags (name, color, description).

Inputs: no named parameters. Returns: result

list_my_listsB

List your custom game lists (id, title, published, number of games, last update). Read-only.

Inputs: limit, offset. Returns: result

list_play_recordsB

Read the Play Records of one copy: every category (key/value, checklist, progress, table, text) and its rows, numbered from 1. Read-only.

Inputs: slug (required), wait_ms, collection_id. Returns: result

list_playthroughsB

List playthroughs of one copy with their sessions (date, minutes, status, notes). A copy always shows a default "Playthrough" until you save one.

Inputs: slug (required), collection_id. Returns: result

list_playtime_contributionsB

List the playtime figures you have submitted, newest first. Read-only.

Inputs: limit, offset. Returns: result

list_wishlistB

List the games on your wishlist with notes, pre-order and favourite flags. Read-only.

Inputs: limit, offset. Returns: result

loginB

Sign in with IB_USERNAME and IB_PASSWORD from the environment.

Types them into the Infinite Backlog login form. If either value is missing, nothing is typed. Use the Playwright window instead (open_site with headless=false).

Inputs: headless. Returns: result

open_siteB

Open a page on infinitebacklog.net in this server's browser window.

Asks which browser to use first if none was chosen. The window is visible by default (Infinite Backlog renders blank in headless mode). Sign in once there; later calls reuse it.

Inputs: path, wait_ms, headless. Returns: result

remove_from_wishlistB

Remove a game from your wishlist. Needs confirm=true.

Inputs: slug (required), confirm. Returns: result

remove_game_contentA

Detach DLC/packs from a copy. Needs confirm=true. Does not touch the parent copy itself.

Inputs: names (required), parent_slug (required), confirm, collection_id. Returns: result

remove_play_recordA

Remove one row (row_index, 1-based) from a Play Records category, or the whole category when row_index is empty (needs confirm=true).

Inputs: slug (required), category (required), confirm, wait_ms, +2 more. Returns: result

remove_play_sessionC

Delete one play session by id. Needs confirm=true.

Inputs: slug (required), session_id (required), confirm, collection_id. Returns: result

remove_playthroughC

Delete a playthrough and all its sessions. Needs confirm=true.

Inputs: slug (required), playthrough (required), confirm, collection_id. Returns: result

search_gamesA

Search the Infinite Backlog catalog. Returns name, slug, year and category per hit.

Use the slug with the other tools. Duplicate titles get IGDB-style slugs (Hades 1995 is hades, Hades 2020 is hades--1).

Inputs: query (required), limit, offset. Returns: result

set_game_acquisitionB

Acquisition and condition on one copy. acquisition: purchase, subscription, gift, trade, keyBundle, promotionalCopy, reviewCopy, free, freeToPlay. source: store or shop name (matched to IB's purchase places). date YYYY-MM-DD. amount and additional_costs are normal prices in your IB currency (9.99); the tool stores them the way IB does. digital_service: steam, epicGameStore, gog, psn, xboxLive, nintendoEShop, ... state new/used. condition cib/incomplete/loose/sealed. condition_game/box/manual: mint/good/acceptable/poor/missing/na. clear_fields empties any of those names.

Inputs: slug (required), date, notes, state, +11 more. Returns: result

set_game_detailsC

Basic info on one copy: platform, ownership (owned, household, subscription, borrowed, rented, unlicensed, formerlyOwned, lentOut, other), digital true/false, region (pal/EU, ntsc-u/US, ntsc-j/JP, ntsc-c, australia, brazil, asia, korea, other), edition (slug of an edition from list_related_content), lent_to, borrowed_from. clear_fields: edition, region, lent_to, borrowed_from.

Inputs: slug (required), region, digital, lent_to, +6 more. Returns: result

set_game_progressB

Set progress on one copy: status (unplayed/playing/played/noStatus), completion (notStarted/unfinished/beaten/completed/continuous/dropped), progress bar 0-100, notes, playtime (hours + minutes, saved as manual unless playtime_type says otherwise), finished playthroughs count, and completion date (YYYY, YYYY-MM or YYYY-MM-DD). playtime_type: manual, playthrough or synced. clear_fields empties: notes, progress, playtime, times_completed, completion_date.

Inputs: slug (required), hours, notes, status, +8 more. Returns: result

set_game_ratingA

Rate a game 1-10 overall, with optional 1-10 sub-ratings for Gameplay, Story, Visual, Audio and Playability. Ratings are per game, not per copy. clear=true removes your rating. Sub-ratings you leave blank keep their current value.

Inputs: slug (required), audio, clear, score, +6 more. Returns: result

set_game_tagsB

Add or remove custom tags on one copy. add/remove: comma-separated names or a JSON array. Tags that do not exist yet are created only with create_missing=true (supporter feature; otherwise feature_locked).

Inputs: slug (required), add, color, remove, +2 more. Returns: result

set_play_recordA

Add or update one row in a Play Records category. action: add or update (update needs row_index, 1-based, or a matching name). keyValue: name + value. checkbox: name + unlocked=true/false (value=true also works). progress: name + progress_earned/progress_total (or value "3/10"), optional description. table: values as JSON array or "a | b | c". text: content (or value). earned_date YYYY-MM-DD where the category allows dates.

Inputs: slug (required), category (required), name, value, +11 more. Returns: result

set_play_record_categoryA

Add a Play Records category to one copy, or edit an existing one (matched by name or category_id). type (new categories, default keyValue): keyValue, checkbox, progress, table, text. layout: 1 or 2 columns. parent: put it under another category. rename: new name for an existing category. description_available / date_available: true/false to show those row fields. table_columns: column count for a new table. Categories belong to this copy only, not your profile.

Inputs: name (required), slug (required), type, layout, +10 more. Returns: result

set_playthroughA

Create or edit a playthrough on one copy. create=true adds a new one; otherwise playthrough (id or name) picks the one to edit, and an unsaved default playthrough is saved first. type: firstPlaythrough, replay, speedrun, coop, competitive, continuous, streaming, achievements, challengeRun. playtime_type: session (sum of sessions) or playthrough (set hours/minutes directly). hours/minutes set the manual duration. extra_hours/extra_minutes set playtime_offset: minutes added on top of the session total.

Inputs: slug (required), name, type, hours, +9 more. Returns: result

share_play_recordsC

Share the Play Records of one copy with another copy of the same game (share=true), or stop sharing with that copy (share=false).

Inputs: slug (required), to_collection_id (required), from_collection_id (required), share. Returns: result

submit_playtimeA

Submit your time to beat and time to complete a game to Infinite Backlog's public playtime data. Needs a copy marked Beaten or Completed and confirm=true. There is no delete: a submission can only be changed by submitting again.

Inputs: slug (required), confirm, beaten_hours, beaten_minutes, +2 more. Returns: result

update_listA

Edit your own custom list: title, description, add_games / remove_games (slugs or ids), ranked and publish ("true"/"false"). Only the fields you pass change.

Inputs: list_id (required), title, ranked, publish, +3 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 50 tools

    Disambiguation4/5

    Most tools target clearly distinct resources and actions, and descriptions explain the boundaries between similar-looking tools such as add_game_to_collection vs add_game_platform_copy and the various set_game_* operations. There is still some potential confusion among the many collection/lists/play-record read tools and the browser-control tools mixed into the same surface.

    Naming Consistency4/5

    The set is overwhelmingly consistent snake_case verb_noun naming (list_collection, add_game_to_collection, set_game_progress, remove_play_session, delete_list). Minor deviations like current_url, login, and open_site are readable but not perfectly aligned with the dominant pattern.

    Tool Count2/5

    Fifty tools is very heavy for an MCP surface, even for a broad backlog-management domain. Many operations are legitimately distinct, but the count likely makes tool selection and schema overhead burdensome for an agent.

    Completeness5/5

    The surface covers the domain thoroughly: collection copies, progress, acquisition, tags, ratings, reviews, DLC, play records, playthroughs, sessions, custom lists, wishlist, achievements, stats, and browser/session handling. Obvious lifecycle operations have corresponding create/read/update/delete or equivalent tools.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to drive a Chromium-based browser for web research, testing, and automation with Playwright-compatible tools, persistent profiles, proxy matching, extension loading, and humanized input across local or containerized deployments.
      280 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to automate Chromium browsing with Playwright-compatible tools for web research, testing, and routine tasks, including persistent profiles, extensions, proxy-aware regional QA, and humanized input over npm or Docker.
      280 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to automate real Chromium browsing with Playwright-compatible tools, supporting web research, testing workflows, persistent profiles, proxies, extensions, and stdio or Streamable HTTP deployment.
      280 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables agents to control a visible Chromium browser via Playwright with tools for tabs, page reading, element finding, form input, mouse/keyboard actions, screenshots, console/network inspection, JavaScript execution, viewport emulation, and batched calls.
      17 npm
      MIT