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

Setup

Requires Node.js 18+.

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_DATA_PATH": "/path/to/LaunchBox"
      }
    }
  }
}

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_DATA_PATH": "/path/to/LaunchBox"
      }
    }
  }
}

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.

Each result includes: id, title, platform, installed status, play time, and a confidence score (0-1, higher is better). Use get_game_details for full metadata.

Tool: search_games

Check Library

Check which games from a list are already in the library. 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). Returns matches with confidence scores and a summary of how many you own vs. how many are new.

Tool: check_library

Get Game Details

Get full details for a specific game by its ID. Returns metadata (title, platform, developer, publisher, genre, release date, series, etc.) and play data (play count, play time, last played, date added, installed, completed, progress, personal rating).

Tool: get_game_details

List Platforms

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

Tool: list_platforms

Find Duplicates

Find games owned on multiple platforms, grouped by title.

Tool: find_duplicates

Get Stats

Get library summary statistics (total games, total platforms, top 10 platforms by game count). No parameters needed.

Tool: get_stats

Reload Library

Reload all game data from disk. Use after adding or removing games in LaunchBox. No parameters needed.

Tool: reload_library

License

MIT