lodordev/mcp-romm

An MCP server for RomM — the self-hosted retro game library manager. 40 tools: 26 read-only for browsing platforms, searching ROMs, viewing metadata, collections (regular, smart, and virtual), saves, play activity, and tasks — plus 14 write tools for play status, play sessions, favorites, notes, and collection management, through any MCP-compatible AI assistant.
Tools
Read
| Tool | Description |
|------|-------------|
| romm_status | Check server configuration and reachability |
| romm_stats | Library-wide statistics (platforms, ROMs, saves, total size) |
| romm_platforms | List platforms with ROM counts and sizes |
| romm_library_items | Browse ROMs with filtering and pagination |
| romm_recent | Recently added or updated ROMs |
| romm_get_item | Full ROM detail — metadata, saves, user status |
| romm_search | Search ROMs by name |
| romm_search_by_hash | Identify a ROM by file hash (CRC, MD5, SHA1, or RetroAchievements) |
| romm_filters | Available filter values (genres, regions, languages, tags) |
| romm_collections | List user-curated collections |
| romm_collection_detail | List ROMs in a specific collection |
| romm_smart_collections | List auto-generated smart collections |
| romm_saves | List save files by ROM or platform |
| romm_user_profile | Browse by status (now playing, backlog, completed, etc.) |
| romm_rom_notes | View notes on a ROM |
| romm_firmware | List BIOS/firmware files per platform |
| romm_devices | List registered devices |
| romm_tasks | List registered tasks (schedule, manual-run availability) and running status |
| romm_scan_library | Trigger a background library rescan (blocked over REST on RomM 5.0 — see Known issues) |
| romm_activity | Recent play activity feed — who played what, when (5.0+) |
| romm_play_sessions | List recorded play sessions with durations (5.0+) |
| romm_virtual_collections | Automatic groupings by genre/franchise/company/etc. (5.0+) |
| romm_virtual_collection_detail | List ROMs in a virtual collection (5.0+) |
| romm_smart_collection_detail | A smart collection's rules and matching ROMs (5.0+) |
| romm_whoami | Authenticated account, role, and effective permissions |
| romm_metadata_search | Search metadata providers (IGDB etc.) for ROM matches (5.0+) |
Write
These modify **your own** user data and collections. They cannot alter ROM files, platforms, firmware, other users, or save files.
| Tool | Description |
|------|-------------|
| romm_set_status | Set play status, backlog, now-playing, rating, completion, last-played |
| romm_favorite | Add or remove a ROM from your favorites |
| romm_add_note | Add a note to a ROM |
| romm_update_note | Edit an existing note |
| romm_delete_note | Delete a note (permanent) |
| romm_create_collection | Create a new collection |
| romm_add_to_collection | Add ROMs to a collection |
| romm_remove_from_collection | Remove ROMs from a collection |
| romm_delete_collection | Delete a collection — the grouping only, not the ROMs (permanent) |
| romm_log_play_session | Record a play session on a ROM (5.0+) |
| romm_delete_play_session | Delete one of your play sessions (permanent, 5.0+) |
| romm_create_smart_collection | Create a smart collection — a saved filter that auto-matches ROMs (5.0+) |
| romm_update_smart_collection | Edit a smart collection's name/description/rules (5.0+) |
| romm_delete_smart_collection | Delete a smart collection — the saved filter only (permanent, 5.0+) |
Setup
Prerequisites
- Python 3.10+
- A running RomM instance (v5.0+; most read tools also work on v4.4+)
- An **enabled** RomM user account — admin is not required (see Auth)
Install