steam-library-mcp
This server provides a read-only MCP interface for comprehensive Steam library intelligence, with optional action tools protected by confirmation safeguards.
Library & Profile
Retrieve profile summary, resolve vanity URLs to SteamID64, list owned games with playtime, search library by name, get detailed game info, and view recently played games.
Achievements
View achievement progress and locked objectives (including hidden ones with opt-in), with global rarity info and per-game schema.
Local Installation
List locally installed Steam games, audit disk usage, find large games, plan non-destructive storage cleanup, and read local update schedules.
Wishlist & Store
Fetch your wishlist, monitor for new releases, demos, price drops, date changes, and playtest/beta news via snapshot comparison. Build concise store briefs (price, reviews, DLC, platforms, features) and discover current discounts on wishlisted or featured items.
Recommendations & Discovery
Get taste-based game recommendations from your library based on mood, available time, and play history; discover new games matching your taste profile.
Social & Co-op Planning
Find games shared with selected friends, incorporating online status and co-op/multiplayer Store metadata.
Reports & Cache
Generate a Markdown weekly brief covering wishlist changes, forgotten owned games, and new discovery picks. Manually refresh cached Steam API data selectively.
Optional Actions (require STEAM_ENABLE_ACTIONS=true + user confirmation)
Launch games, open store/community/achievement pages, initiate install flows, uninstall games (requires additional
STEAM_ALLOW_UNINSTALL=trueflag and multiple confirmations), prepare game night invites (opens chat windows, never sends), open the download manager, and manage local notes, backlog status, and mood tags.
Security & Privacy: Read-only by default, no credentials stored, no purchases or trades, logs to stderr only, no telemetry.
Provides tools for interacting with the Steam platform, enabling AI agents to manage Steam library, wishlist, achievements, discover games, and more.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@steam-library-mcp Do I own Outriders?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
steam-library-mcp
A TypeScript MCP server for Steam library intelligence: ownership, store/review/DLC briefs, deals, taste-based discovery, wishlist releases, co-op planning, achievement objectives, storage, updates, and confirmed local actions.
It is model-agnostic: any MCP client/host that supports local stdio servers can run it, not just Codex. See docs/mcp-client-setup.md for Claude Desktop/Code, Codex, and generic MCP client setup patterns.
The server is read-only toward your Steam account by default. It does not buy, trade, gift, automatically send chat messages, modify your account, scrape Steam login pages, read cookies, store sessions, or handle Steam credentials.
Optional action tools can be enabled, but only with STEAM_ENABLE_ACTIONS=true. Launch/install/browser/chat-window/download-window tools require confirmation and default to dry-run previews where applicable. The friend-invite helper only opens existing friends' chats and never presses Send. Uninstall additionally requires STEAM_ALLOW_UNINSTALL=true, verifies the game is locally installed, asks through MCP user elicitation when supported (or requires exact confirmation text), and only opens Steam's own native confirmation flow.
What It Can Answer
Do I own Outriders?
What games have I bought but barely played?
What have I played recently?
What Steam games are installed locally?
Recommend something from my Steam library for a 1-hour session.
Show my achievement progress for this game.
What changed on my Steam wishlist this week?
Did any wishlisted games release or announce a playtest, beta, or demo?
Steam owned-game API data does not include reliable genres or tags. Recommendations are based on available playtime, recent activity, installed status, name/query matches, and optional local MCP tags.
Related MCP server: Steam Library MCP Server
Security Model
Read-only mode is the default.
Action and local-write tools are not registered unless
STEAM_ENABLE_ACTIONS=true.No Steam password, cookie, Steam Guard, browser data, or login session handling.
No purchases, trades, gifts, automated chat sends, profile changes, account changes, silent installs, or silent uninstalls.
API keys are read from environment variables only.
API keys are redacted from thrown errors.
Logs go to stderr, not stdout, so MCP stdio is not polluted.
No telemetry and no third-party analytics.
Cache/state files may contain owned games, wishlist items, release metadata, playtime, achievement progress, profile summary data, local notes, local tags, backlog status, and action history. Treat STEAM_CACHE_DIR, STEAM_WISHLIST_STATE_PATH, STEAM_LOCAL_DB_PATH, and STEAM_ACTION_LOG_PATH as private.
Wishlist retrieval uses Steam's first-party but undocumented IWishlistService/GetWishlist/v1 endpoint because Steam has no documented consumer wishlist API. Names, release status, and demo availability come from the first-party but undocumented Store appdetails endpoint. Either may change, and access can depend on Steam privacy settings. Playtest/beta monitoring uses best-effort keyword matching against Steam's documented public news API; matches are signals, not guaranteed availability.
Requirements
Node.js 20+
A Steam Web API key
Your SteamID64
Public-enough Steam profile/game details for the data you want Steam to return
Get a Steam Web API key at:
https://steamcommunity.com/dev/apikeyFind your SteamID64 from your profile URL, a Steam ID lookup site, or by setting STEAM_VANITY_NAME and using the steam_resolve_vanity_url tool after setup.
Setup
cd /ABSOLUTE/PATH/TO/steam-library-mcp
npm install
cp .env.example .envEdit .env:
STEAM_API_KEY=your_steam_web_api_key_here
STEAM_ID_64=your_17_digit_steamid64_hereThe server loads .env from its current working directory for direct local runs. Environment variables passed by Codex or your shell take precedence.
If you want Codex to guide the setup for you, use the playbook in docs/setup-with-codex.md. It covers the same safe flow used to set this up locally: discover SteamID64 from Steam account metadata, open the official API key page, handle the Steam Guard Mobile Authenticator requirement, and verify the key without printing it.
Helpful setup scripts:
npm run setup:accounts
npm run setup:verifyBuild and test:
npm run check
npm run test
npm run buildWith a private .env and a built server, an exhaustive live-but-safe pass is available:
npm run qa:fullIt calls all 34 tools, uses temporary cache/state paths, and keeps every external action in dry-run mode.
Start directly:
npm run startEnvironment Variables
Required:
Variable | Purpose |
| Steam Web API key. Never commit this. |
| Default SteamID64 to query. |
Read-only options:
Variable | Default | Purpose |
| unset | Optional vanity profile name. |
|
| Include played free games in owned-game results. |
|
| Cache TTL for Steam API responses. |
| OS user cache dir | Cache location. |
| auto-detect | Override local Steam library path or |
|
| Steam API request timeout. |
| cache dir JSON | Persistent local wishlist comparison state. |
|
| Maximum wishlist apps enriched with Store release/demo metadata per check. |
|
| Country used for Store metadata. |
|
| Language used for Store metadata. |
|
| Include local taste-based new-game recommendations in weekly briefs. |
|
| Most-played owned games sampled for the local taste profile. |
|
| Featured Store candidates enriched and scored per discovery run. |
| cache dir Markdown | Suggested destination used by the weekly Python companion. |
Action/local options:
Variable | Default | Purpose |
|
| Registers the optional action/local-write tools. Leave unset/false for a 21-tool read-only surface. |
|
| Requires exact confirmation text for browser and local write actions. Launch/install always require exact confirmation. |
|
| Allows tools that open Steam web pages in your browser when actions are enabled. |
|
| Allows validated Steam protocol opens when actions are enabled. Uninstall still needs its separate flag. |
|
| Separately enables opening Steam's native uninstall confirmation flow. |
|
| Reserved safety flag. The tools do not expose arbitrary launch args by default. |
|
| Allows writes to the MCP local database only. |
| cache dir JSONL | Local action audit log path. |
|
| Rotates the active action log before it exceeds this size. |
|
| Number of rotated action-log files retained. |
| cache dir JSON | MCP-owned local notes/backlog/tags DB path. |
|
| Maximum serialized local notes database size. |
|
| Maximum notes retained per game. |
|
| Maximum characters in one note. |
To omit all action and local-write tools from MCP discovery, keep:
STEAM_ENABLE_ACTIONS=falseYou can also deny-list action tools in Codex config.
Tools
Steam-account-read-only tools (some update local cache/state files):
steam_get_profilesteam_resolve_vanity_urlsteam_get_owned_gamessteam_search_librarysteam_get_gamesteam_get_recently_playedsteam_get_achievementssteam_get_installed_gamessteam_library_statssteam_recommend_from_librarysteam_get_wishliststeam_check_wishlist_updatessteam_game_briefsteam_find_dealssteam_discover_gamessteam_storage_commandersteam_update_centersteam_achievement_objectivessteam_plan_game_nightsteam_weekly_briefsteam_refresh_cache
Optional action/local tools:
steam_launch_gamesteam_open_store_pagesteam_open_community_hubsteam_open_achievements_pagesteam_open_install_flowsteam_uninstall_gamesteam_prepare_game_night_invitessteam_open_download_managersteam_add_local_game_notesteam_set_local_backlog_statussteam_set_local_mood_tagssteam_get_local_game_notessteam_action_history
Confirmation Text
When actions are enabled, these tools require exact confirmation text:
Tool | Confirmation |
|
|
|
|
| Built-in MCP user confirmation when supported, or exact |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Launch and install-flow tools default to dryRun=true. They only open Steam when dryRun=false and confirmation is correct. Install flow only opens Steam's own steam://install/<appid> flow; Steam may prompt you and the MCP does not silently install anything.
Browser-opening tools only open HTTPS URLs on Steam-owned domains. Steam protocol tools only allow validated run/install/uninstall app IDs, the Downloads page, and message windows for 17-digit friend IDs.
The uninstall tool never deletes manifests or game directories. A dry run returns the required confirmation without changing anything. A real call requires action mode, the separate uninstall flag, a locally installed app, user confirmation, and then Steam's own native confirmation dialog.
Local notes, backlog status, and mood tags are stored only in the MCP local database. They never modify Steam files.
Wishlist Monitoring And Automations
steam_get_wishlist reads a wishlist without using cookies or a browser session. steam_check_wishlist_updates compares it with local state and reports newly released games, newly available demos, same-currency price drops, release-date changes, additions/removals, and recent Steam news posts that mention playtests, betas, demos, alphas, technical tests, or free weekends.
steam_weekly_brief also returns Markdown containing owned-game rediscovery picks and optional taste-based new-game recommendations. The MCP does not schedule itself. A Codex automation can call the tool directly; the included scripts/steam-weekly-watch.py can call it over stdio and atomically write the Markdown for Task Scheduler or another host. The first run creates a baseline without reporting every existing item as new.
See docs/wishlist-monitoring.md for automation and privacy details, docs/feature-guide.md for every new feature and caveat, docs/publishing.md for packaging/version behavior, and docs/audit.md for the safety audit.
Codex MCP Registration
This section is Codex-specific. For Claude Desktop, Claude Code, Gemini/Grok-capable MCP hosts, IDE agents, or generic MCP clients, see docs/mcp-client-setup.md.
macOS/Linux:
npm install
npm run build
codex mcp add steam-library \
--env STEAM_API_KEY="$STEAM_API_KEY" \
--env STEAM_ID_64="$STEAM_ID_64" \
-- node /ABSOLUTE/PATH/TO/steam-library-mcp/dist/index.js
codex mcp listWindows PowerShell:
npm install
npm run build
codex mcp add steam-library `
--env STEAM_API_KEY="$env:STEAM_API_KEY" `
--env STEAM_ID_64="$env:STEAM_ID_64" `
-- node C:\ABSOLUTE\PATH\TO\steam-library-mcp\dist\index.js
codex mcp listAction mode example:
codex mcp add steam-library \
--env STEAM_API_KEY="$STEAM_API_KEY" \
--env STEAM_ID_64="$STEAM_ID_64" \
--env STEAM_ENABLE_ACTIONS=true \
--env STEAM_REQUIRE_CONFIRMATION=true \
--env STEAM_ALLOW_UNINSTALL=false \
-- node /ABSOLUTE/PATH/TO/steam-library-mcp/dist/index.jsCodex config.toml example with approval prompts:
[mcp_servers.steam-library]
command = "node"
args = ["/ABSOLUTE/PATH/TO/steam-library-mcp/dist/index.js"]
startup_timeout_sec = 10
tool_timeout_sec = 60
default_tools_approval_mode = "prompt"
enabled = true
[mcp_servers.steam-library.env]
STEAM_API_KEY = "your_steam_web_api_key_here"
STEAM_ID_64 = "your_17_digit_steamid64_here"
STEAM_ENABLE_ACTIONS = "false"
[mcp_servers.steam-library.tools.steam_get_owned_games]
approval_mode = "auto"
[mcp_servers.steam-library.tools.steam_search_library]
approval_mode = "auto"
[mcp_servers.steam-library.tools.steam_launch_game]
approval_mode = "prompt"
[mcp_servers.steam-library.tools.steam_open_install_flow]
approval_mode = "prompt"Read-only-only Codex config:
[mcp_servers.steam-library]
command = "node"
args = ["/ABSOLUTE/PATH/TO/steam-library-mcp/dist/index.js"]
default_tools_approval_mode = "prompt"
disabled_tools = [
"steam_launch_game",
"steam_open_store_page",
"steam_open_community_hub",
"steam_open_achievements_page",
"steam_open_install_flow",
"steam_uninstall_game",
"steam_prepare_game_night_invites",
"steam_open_download_manager",
"steam_add_local_game_note",
"steam_set_local_backlog_status",
"steam_set_local_mood_tags",
"steam_get_local_game_notes",
"steam_action_history"
]
[mcp_servers.steam-library.env]
STEAM_API_KEY = "your_steam_web_api_key_here"
STEAM_ID_64 = "your_17_digit_steamid64_here"
STEAM_ENABLE_ACTIONS = "false"Codex reads MCP server instructions during initialization. This server instructs agents to search before ownership answers, respect Steam visibility caveats, and avoid write actions unless explicitly enabled and confirmed.
Example Prompts
Do I own Outriders?Search my Steam library for worldslayer.What have I played recently?What games have I bought but barely played?List locally installed Steam games.Recommend something installed for a 1-hour session.Show my achievement progress for a game without hidden-achievement spoilers.Reveal the hidden achievement objectives for this game and tell me which official descriptions are unavailable.Build my weekly Steam brief with wishlist price drops and new-game discovery.Find co-op games I share with these friends.Audit my installed games and make a plan to free 100 GB without touching favorites.Dry-run launching OUTRIDERS and tell me the exact confirmation text.Dry-run uninstalling an installed game and tell me what confirmations would be required.Check my wishlist for releases or new playtest, beta, and demo news.
Local Steam Detection
The MCP reads:
libraryfolders.vdfappmanifest_*.acf
Common paths checked:
Windows:
C:\Program Files (x86)\Steam\steamapps\libraryfolders.vdfWindows:
C:\Program Files\Steam\steamapps\libraryfolders.vdfmacOS:
~/Library/Application Support/Steam/steamapps/libraryfolders.vdfLinux:
~/.steam/steam/steamapps/libraryfolders.vdfLinux:
~/.local/share/Steam/steamapps/libraryfolders.vdf
Set STEAM_LOCAL_LIBRARY_PATH if your Steam library is elsewhere.
Credits
Steam Library MCP was conceived and directed by @Dark-Hunt3r1, who defined its requirements, safety boundaries, and product decisions and remains its maintainer.
OpenAI Codex was used as an AI development tool for substantial implementation, test creation and execution, documentation, security review, sanitization, and release preparation.
This is an independent project and is not affiliated with or endorsed by Valve or OpenAI.
Troubleshooting
STEAM_API_KEY is required
Set STEAM_API_KEY in the MCP environment. Do not put it in source code.
STEAM_ID_64 is required
Set STEAM_ID_64 to your 17-digit SteamID64. If you know only a vanity name, use steam_resolve_vanity_url after setup or resolve it externally.
Empty owned library response
Check Steam profile and game-details privacy settings. Steam may omit hidden/private games, family-shared games, free games without playtime, or metadata it cannot expose through the Web API.
Achievement errors
Some games do not expose achievements through Steam Web API. Profile privacy or game privacy can also block achievement access.
HTTP 401/403
Check the API key, SteamID64, privacy settings, and whether the key is valid for the requested endpoint.
HTTP 429
Steam rate-limited the request. Wait and retry, or avoid forceRefresh.
Local installed games missing
Set STEAM_LOCAL_LIBRARY_PATH to a Steam root folder, a steamapps folder, or a specific libraryfolders.vdf. The MCP only reads local manifest files and never treats local install status as proof of ownership.
Action tool is missing
Set STEAM_ENABLE_ACTIONS=true and restart/reload the MCP server. Tool registration is decided at startup. Keep default_tools_approval_mode = "prompt" in Codex if you want Codex to ask before calling action tools.
Wrong confirmation
Use the exact confirmation string for the resolved appid, for example LAUNCH 680420.
Wishlist unavailable
Steam does not provide a documented consumer wishlist API. The MCP uses first-party but undocumented wishlist and Store metadata endpoints without cookies or login scraping. Availability can depend on Steam privacy settings; if Valve changes either endpoint, the tool returns an explicit error or marks missing metadata unavailable instead of guessing.
Uninstall tool is missing or says disabled
Set both STEAM_ENABLE_ACTIONS=true and STEAM_ALLOW_UNINSTALL=true, then restart the MCP. Keep host-level approval prompts enabled. The tool still requires MCP user elicitation or exact UNINSTALL <appid> confirmation, verifies the app is installed, and Steam displays another native confirmation.
Available Tools
21 toolssteam_achievement_objectivesSteam Achievement ObjectivesARead-onlyIdempotent
List locked achievement objectives and global rarity, with explicit opt-in before revealing hidden titles/descriptions exposed by Steam's schema.
Inputs: name, appid, forceRefresh, revealHiddenTitles. Returns: data, summary
steam_check_wishlist_updatesCheck Steam Wishlist UpdatesC
Compare the current wishlist with a local snapshot for releases, demos, date changes, additions, removals, and playtest/beta/demo news signals.
Inputs: steamid, sinceDays, maxNewsApps, saveSnapshot, +2 more. Returns: data, summary
steam_discover_gamesDiscover Steam GamesBRead-onlyIdempotent
Analyze the most-played part of the library into a transparent taste profile, then recommend new featured games and forgotten owned games.
Inputs: limit, includeNewGames. Returns: data, summary
steam_find_dealsFind Steam DealsARead-onlyIdempotent
Find current wishlist and featured Store discounts, prioritizing the wishlist and excluding already-owned featured games.
Inputs: limit, maxMetadataApps. Returns: data, summary
steam_game_briefSteam Game BriefBRead-onlyIdempotent
Build one useful Store brief with price, release state, review summary, DLC, demos, platforms, controller/co-op features, and ownership/install status.
Inputs: name, appid, dlcLimit, forceRefresh, +2 more. Returns: data, summary
steam_get_achievementsGet Steam AchievementsC
Get achievement progress for a specific appid or game name.
Inputs: name, appid, forceRefresh, includeSchema, +1 more. Returns: data, summary
steam_get_gameGet Steam GameC
Get details for one game in my library by appid or name.
Inputs: name, appid, forceRefresh, includeAchievements, +1 more. Returns: data, summary
steam_get_installed_gamesGet Installed Steam GamesC
List Steam games installed locally on this computer.
Inputs: libraryPath, includeOwnedMetadata. Returns: data, summary
steam_get_owned_gamesGet Owned Steam GamesD
Get my owned Steam games.
Inputs: limit, sortBy, forceRefresh, sortDirection, +2 more. Returns: data, summary
steam_get_profileGet Steam ProfileC
Get my Steam profile summary from Steam ID or vanity name.
Inputs: steamid, vanityName, forceRefresh. Returns: data, summary
steam_get_recently_playedGet Recently Played Steam GamesC
Get my recently played Steam games.
Inputs: count, forceRefresh. Returns: data, summary
steam_get_wishlistGet Steam WishlistC
Get a Steam wishlist through Steam's first-party but undocumented wishlist service and Store metadata endpoints.
Inputs: limit, steamid, unreleasedOnly, maxMetadataApps. Returns: data, summary
steam_library_statsSteam Library StatsC
Summarize my Steam library.
Inputs: forceRefresh. Returns: data, summary
steam_plan_game_nightPlan Steam Game NightARead-onlyIdempotent
Find games shared with selected or currently visible friends, with online status and co-op/multiplayer Store metadata when available.
Inputs: limit, maxFriends, friendNames, friendSteamIds, +1 more. Returns: data, summary
steam_recommend_from_libraryRecommend From Steam LibraryC
Recommend games from my Steam library based on mood, available time, and discovery preference.
Inputs: mood, limit, queryTerms, excludeTerms, +3 more. Returns: data, summary
steam_refresh_cacheRefresh Steam CacheC
Refresh cached Steam API data.
Inputs: target. Returns: data, summary
steam_resolve_vanity_urlResolve Steam Vanity URLB
Resolve a Steam vanity URL name to SteamID64.
Inputs: vanityName (required). Returns: data, summary
steam_search_librarySearch Steam LibraryC
Search my owned Steam games by fuzzy name/query.
Inputs: query (required), limit, forceRefresh, includeInstalledStatus. Returns: data, summary
steam_storage_commanderSteam Storage CommanderARead-onlyIdempotent
Audit installed-game storage, find large games, or build a non-destructive make-room/uninstall plan using size, playtime, recency, backlog, and protected local tags.
Inputs: mode, limit, protectedTags, neededGigabytes. Returns: data, summary
steam_update_centerSteam Update CenterARead-onlyIdempotent
Read local appmanifest update and schedule evidence without modifying Steam's private queue or configuration.
Inputs: no named parameters. Returns: data, summary
steam_weekly_briefSteam Weekly BriefARead-only
Create a Markdown-ready weekly brief with wishlist releases, demos, price drops, beta/playtest news, forgotten owned games, and optional new-game discovery.
Inputs: maxNewsApps, saveSnapshot, maxMetadataApps, includeDiscovery. Returns: data, summary
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Each tool targets a unique aspect of Steam library management, from listing games and achievements to managing storage and creating weekly briefs. Despite several get_-prefixed tools, they clearly differ by the specific data retrieved (e.g., achievements vs. owned games). No two tools appear to have overlapping functionality.
All tool names follow a consistent pattern: the steam_ prefix followed by descriptive, snake_case phrases. Verbs like get_, find_, and check_ are used predictably, and even compound names like steam_achievement_objectives or steam_plan_game_night are clearly readable. No mixing of conventions occurs.
With 21 tools, the server covers a broad range of library-related operations without being overwhelming. Each tool addresses a distinct need, and the count feels proportional to the complexity of Steam's library feature set.
The tools provide comprehensive coverage of library operations: retrieval, search, statistics, achievements, wishlist, storage, updates, recommendations, and social planning. While write operations like removing games are absent, the server's scope aligns with a library-focused assistant, leaving few obvious gaps.
Maintenance
Related MCP Connectors
Steam backlog, account value, buy-or-skip verdicts and Steam Machine checks. Hosted, keyless.
Read-only Steam wishlist, sales and refund data for game developers, from Steamworks.
Live Steam market data for AI agents: top sellers, deals, player counts. Paid per call via x402.
Read-only PC game search, current store offers and recorded price history. No account required.
Related MCP Servers
- AlicenseAqualityDmaintenanceIntegrates with Steam Web API to enable querying user profiles, game libraries, store data, and community features like reviews and workshop items.16MIT
- FlicenseNot gradedqualityDmaintenanceProvides access to your Steam game library data through Claude Desktop, enabling game search, filtering, details, recommendations, and statistics.7-
- AlicenseAqualityBmaintenanceEnables interaction with Steam: search games, get store details, reviews, prices, discounts, news, and player profiles, libraries, and achievements via the Steam Web API.26256 npm5MIT
- AlicenseAqualityCmaintenanceEnables browsing and filtering a local Steam library and managing Steam collections, including collection read/write operations not available through a web API.23MIT