Query your LaunchBox game library directly from your AI assistant.
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
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | Yes | Search text to match against titles |
platform |
string | No | Filter by platform name |
limit |
number | No | Max results to return (default 25) |
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
| Parameter | Type | Required | Description |
|---|---|---|---|
games |
string[] | Yes | Array of game title strings to look up (1-100) |
platform |
string | No | Filter matches to a specific platform |
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
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string | Yes | The game ID (UUID from search results) |
include_notes |
boolean | No | Include the Notes field (default false) |
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
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | No | Optional title filter (fuzzy match) |
limit |
number | No | Max duplicate groups to return (default 25) |
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
Tools (7)
search_gamesSearch the game library by title using fuzzy matching.check_libraryCheck which games from a list are already in the library.get_game_detailsGet full metadata and play data for a specific game by its ID.list_platformsList all platforms in the library with their game counts.find_duplicatesFind games owned on multiple platforms, grouped by title.get_statsGet library summary statistics.reload_libraryReload all game data from disk.Environment Variables
LAUNCHBOX_DATA_PATHrequiredThe file system path to your LaunchBox installation data.Configuration
{"mcpServers": {"launchbox": {"command": "npx", "args": ["-y", "github:danjam/mcp-launchbox"], "env": {"LAUNCHBOX_DATA_PATH": "/path/to/LaunchBox"}}}}