Skip to main content
Glama
Sign In
Lutris MCP Server

Lutris MCP Server

by Praeses0
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

lutris-mcp

MCP server for managing your Lutris game library. Gives AI assistants direct access to browse, search, organize, launch, and install games in your Linux gaming collection.

Examples

Here are some things you can ask your AI assistant once this server is connected:

  • "What games do I have installed?"

  • "Show me my most played games"

  • "Search my Steam library for Hades"

  • "Launch Balatro"

  • "Install this game from /path/to/setup.exe"

  • "Add all my roguelike games to a 'Roguelike' category"

  • "Are there any duplicate games in my library?"

  • "Show me the log for my last Hades II session"

  • "Export my installed games as JSON"

  • "Set the cover art for Timberborn from this image"

Related MCP server: Steam Library MCP Server

Installation

Quick Start (npx)

No install needed — just add to your MCP client config:

{
  "mcpServers": {
    "lutris": {
      "command": "npx",
      "args": ["-y", "lutris-mcp"]
    }
  }
}

Global Install

npm install -g lutris-mcp

Then configure your MCP client:

{
  "mcpServers": {
    "lutris": {
      "command": "lutris-mcp"
    }
  }
}

From Source

git clone https://github.com/Praeses0/lutris-mcp.git
cd lutris-mcp
npm install
npm run build
{
  "mcpServers": {
    "lutris": {
      "command": "node",
      "args": ["/path/to/lutris-mcp/dist/index.js"]
    }
  }
}

Requirements

  • Lutris installed and set up

  • Node.js 20+

Tools

Library

Tool

Description

list_games

List and filter games with pagination, sorting, and smart search

get_game

Get full game details including categories, config, and media paths

add_game

Add a new game to the library

update_game

Update fields on an existing game

remove_game

Remove a game from the database (does not delete files)

get_library_stats

Aggregate stats: totals, playtime, breakdowns by runner/platform/service

find_duplicates

Find potential duplicate games (same directory or similar slugs)

export_library

Export full library as JSON with optional filters (category, runner, installed)

Categories

Tool

Description

list_categories

List all categories with game counts

create_category

Create a new category

assign_category

Add a game to a category

unassign_category

Remove a game from a category

bulk_assign_category

Add multiple games to a category at once

Services

Tool

Description

search_service_games

Search games synced from Steam, GOG, etc.

import_service_game

Import a service game into your Lutris library

Launch & Install

Tool

Description

launch_game

Launch an installed game via Lutris

install_game

Install a game from a Lutris installer slug or local setup executable

check_game_running

Check if a game is currently running (multi-strategy detection)

Configuration

Tool

Description

read_game_config

Read a game's YAML configuration file

write_game_config

Update or create a game's YAML configuration (deep-merged)

Media

Tool

Description

set_game_cover

Set a game's cover art, banner, or icon from a local file

get_game_media

Get all media paths for a game with existence check

System

Tool

Description

list_runners

List available Lutris runners or Wine versions

view_game_log

Read the last launch log for a game (for troubleshooting)

Bulk Operations

Tool

Description

bulk_update_games

Update a field on multiple games at once

Environment Variables

Variable

Default

Description

LUTRIS_DB_PATH

~/.local/share/lutris/pga.db

Path to Lutris SQLite database

LUTRIS_GAMES_CONFIG_DIR

~/.config/lutris/games

Path to game YAML configs

LUTRIS_DATA_DIR

~/.local/share/lutris

Path to Lutris data directory (media, logs)

Development

npm install       # install dependencies
npm run build     # compile TypeScript
npm test          # run tests (219 tests)
npm run dev       # run with tsx (hot reload)

License

MIT

Available Tools

11 tools
add_gameC

Add a new game to the Lutris library

Inputs: name (required), runner (required), platform, directory, +6 more.

assign_categoryC

Add a game to a category

Inputs: game_id (required), category_name (required).

create_categoryC

Create a new game category

Inputs: name (required).

get_gameC

Get full details for a specific game including categories and YAML config

Inputs: id, slug.

get_library_statsB

Get aggregate statistics about the Lutris game library

Inputs: no named parameters.

list_categoriesB

List all categories with game counts

Inputs: no named parameters.

list_gamesC

List and filter games in the Lutris library with pagination

Inputs: runner, platform, installed, category, +6 more.

remove_gameB

Remove a game from the Lutris database (does not delete files)

Inputs: id (required), confirm (required).

search_service_gamesB

Search games from external services (Steam, GOG, etc.) synced in Lutris

Inputs: query, service, limit, offset.

unassign_categoryC

Remove a game from a category

Inputs: game_id (required), category_name (required).

update_gameC

Update fields on an existing game

Inputs: id (required), name, slug, runner, +9 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.5/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity. Tools like add_game, remove_game, and update_game handle different lifecycle stages, while category management tools (create_category, assign_category, unassign_category) are separate from game operations. The search_service_games tool is distinct from list_games, targeting external services versus the local library.

    Naming Consistency5/5

    All tools follow a consistent verb_noun naming pattern (e.g., add_game, list_categories, update_game). The naming is uniform across all 11 tools, using clear action verbs paired with specific nouns, making it easy to predict functionality without any deviations in style.

    Tool Count5/5

    With 11 tools, the count is well-scoped for managing a game library and categories. Each tool serves a clear purpose, such as CRUD operations for games and categories, plus utilities like search and stats, avoiding redundancy while covering the domain comprehensively.

    Completeness5/5

    The tool set provides complete coverage for the Lutris game management domain. It includes full CRUD for games (add, get, update, remove) and categories (create, list, assign/unassign), plus utilities for searching external services and library statistics, leaving no obvious gaps for agent workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • RAWG MCP

      pipeworx-io
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to search a video game database by name, genre, or platform, retrieve detailed game records, and list genres/platforms with game counts. It exposes these capabilities as MCP tools for ratings, Metacritic scores, release dates, developers, publishers, ESRB ratings, and playtime.
      288 npm
      MIT

    • awesome-core

      twojlogin
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to search, filter, and explore a local offline catalog of tools from awesome lists, including finding underrated tools, explaining ranking provenance, listing curator lists, and inspecting catalog facets. All access is read-only over local SQLite with no network calls or API keys.
      19 PyPI
      MIT