MCP LaunchBox

An MCP server that lets AI assistants query your LaunchBox game library. Search your entire game collection across all platforms (Steam, GOG, Epic, emulators, etc.) directly from your AI assistant.

Works with Claude Desktop, Claude Code, or any MCP-compatible client.

Use Cases

• Send a screenshot of a game bundle and check which ones you already own — fuzzy matching handles OCR errors and typos

• Quick lookups before buying a game on sale

• Browse your library by platform or name

• Check how much time you've spent on a game

• Find installed games you haven't played yet

• See what you're currently playing across platforms

Related MCP server: AI Personal Hub

Setup

Requires Node.js 20+.

1. Have a LaunchBox Installation

You'll need LaunchBox installed with your game data.

2. Configure Your MCP Client

Add the server to your MCP client's configuration. There are two ways to do this:

Option A: Run directly from GitHub (no install needed)

{
  "mcpServers": {
    "launchbox": {
      "command": "npx",
      "args": ["-y", "github:danjam/mcp-launchbox"],
      "env": {
        "LAUNCHBOX_PLATFORMS_PATH": "C:/LaunchBox/Data/Platforms"
      }
    }
  }
}

Option B: Clone and run locally

git clone https://github.com/danjam/mcp-launchbox.git
cd mcp-launchbox
npm install

Then point your MCP client at the local build:

{
  "mcpServers": {
    "launchbox": {
      "command": "node",
      "args": ["/path/to/mcp-launchbox/dist/index.js"],
      "env": {
        "LAUNCHBOX_PLATFORMS_PATH": "C:/LaunchBox/Data/Platforms"
      }
    }
  }
}

Replace /path/to/mcp-launchbox with the actual path where you cloned the project.

What You Can Do

Search Games

Search the game library by title. Uses fuzzy matching across title and series fields. Punctuation (dashes, colons, &/and) is normalised before matching by default.

Confidence scale: 1.0 = perfect match, ≥0.85 = very likely, ≥0.65 = probable, <0.65 = speculative. Confidence is penalised when a query token only matches as a substring of a title token (e.g. "Doom" matching "Doomblade"). Results include exactMatch: true when the normalised query equals the normalised title. Use get_game_details for full metadata.

Tool: search_games

Check Library

Check which games from a list are already in the library. Uses normalised title matching first, then fuzzy matching — only matches with confidence ≥0.85 are included to avoid false positives. When exact is true, only exact title matches are returned with no fuzzy or prefix fallback. When no match is found, nearMisses shows up to 5 close candidates for diagnostics. A nearMiss with shorterTitle: true (no confidence field) means a shorter version of the title exists in the library (e.g. "Behind the Frame" for query "Behind the Frame: The Finest Scenery") — search the shorter title to confirm ownership. Punctuation is normalised before matching by default.

Results do not include storefront or version info — use get_game_details for that.

Designed for bundle duplicate checking — pass all the titles in one call instead of searching one at a time. Omit platform to check across all platforms (recommended for bundles).

Tool: check_library

Get Game Details

Get full details for a specific game by its ID. Returns all metadata in camelCase: title, platform, developer, genres (array), series, ratings (communityStarRating and starRating, both 0–5), playTime ({seconds, hours}), installed status, and more. String fields are null when empty/missing.

When a game has alternate versions (e.g. multiple storefronts like Steam/GOG/Epic, ROM regions, or platform ports), a versions array is included. Each entry has version (storefront name or region identifier), installed (boolean), and optionally region (normalised geographic label for ROM variants). Note: source only reflects the import origin of the primary entry, not all owned storefronts — check versions for the full picture.

Tool: get_game_details

List Games

List and filter games in the library. Unlike search_games, this does not do fuzzy matching — it returns games matching the specified filters, sorted and paginated. Use for browsing by platform, installed status, or favorites, and for recency queries like "what did I add this week." Returns total (filtered count) and results (compact game objects without confidence scores, but with dateAdded and lastPlayedDate timestamps).

Tool: list_games

List Platforms

List all platforms in the library with their game counts. No parameters needed.

Tool: list_platforms

Find Duplicates

Find duplicate game entries grouped by title — includes cross-platform and same-platform duplicates.

Tool: find_duplicates

Random Game

Pick a random game from the library, optionally filtered. Use for "what should I play?" or "surprise me" queries. Returns a single game (same shape as list_games results) plus matchPool showing how many games matched the filters. Returns null game when no matches.

Tool: random_game

Get Stats

Get library summary statistics (total games, total platforms, top 10 platforms by game count, and status counts). statusCounts lists all distinct progress values with their counts, sorted descending — use it to discover what free-form status values exist in the library. No parameters needed.

Tool: get_stats

Reload Library

Reload all game data from disk. Use after adding or removing games in LaunchBox. Returns game/platform counts plus added and removed arrays showing what changed since the previous load (id, title, platform for each). On first load, the diff is omitted. If the set of progress/status values changes, a notifications/tools/list_changed notification is sent so clients can re-fetch updated tool schemas. No parameters needed.

Tool: reload_library

License

MIT