steam-mcp

A local Model Context Protocol (MCP) server that connects Claude to your Steam library. Ask natural-language questions about your games without ever touching the API yourself.

Code

"What have I been playing lately?"
"Suggest something from my backlog I haven't touched yet."
"How many hours have I put into RPGs?"
"Tell me about Elden Ring."

Tools

Tool	What it does
`get_library`	Your full game library — title, playtime, last played
`get_recently_played`	Games played in the last 2 weeks
`search_library`	Filter by name, playtime range, or unplayed status
`get_game_details`	Store metadata — genres, tags, Metacritic score, price
`refresh_library`	Clear the cache to fetch fresh data from Steam

Requirements

Node.js 18+
A Steam account with a public profile and library
A Steam Web API key (free, takes 30 seconds to get)

Setup

1. Get a Steam API key

Go to steamcommunity.com/dev/apikey, log in, and register a key. The domain field can be anything (e.g., localhost).

2. Find your Steam ID

You need either:

Your vanity URL username — the custom part of your profile URL: steamcommunity.com/id/YOUR_USERNAME
Your 64-bit Steam ID — find it at steamid.io if you don't have a vanity URL

3. Make your profile public

In Steam: your profile → Edit Profile → Privacy Settings → set My Profile and Game details to Public.

4. Run setup

Terminal

npx steam-mcp setup

This validates your credentials and writes the Claude Desktop config automatically. Restart Claude Desktop when it's done.

Manual config (if you prefer)

Find your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add to the mcpServers section:

config.json

{
  "mcpServers": {
    "steam-mcp": {
      "command": "npx",
      "args": ["-y", "steam-mcp"],
      "env": {
        "STEAM_API_KEY": "your_api_key_here",
        "STEAM_ID": "your_vanity_url_or_64bit_id"
      }
    }
  }
}

Local development

bash

git clone https://github.com/jkiley129/steam-mcp.git
cd steam-mcp
npm install
cp .env.example .env
# Edit .env with your API key and Steam ID
npm run build

To use the local build with Claude Desktop, point the config at the built file:

config.json

{
  "mcpServers": {
    "steam": {
      "command": "node",
      "args": ["/absolute/path/to/steam-mcp/dist/index.js"],
      "env": {
        "STEAM_API_KEY": "your_api_key_here",
        "STEAM_ID": "your_vanity_url_or_64bit_id"
      }
    }
  }
}

Configuration

Environment variable	Required	Description
`STEAM_API_KEY`	Yes	Your Steam Web API key
`STEAM_ID`	Yes	Your 64-bit Steam ID or vanity URL username
`STEAM_MCP_CACHE_DIR`	No	Override cache directory (default: `~/.steam-mcp/cache/`)

Caching

Steam data is cached locally to keep responses fast and avoid hitting rate limits:

Data	Cache TTL
Library	1 hour
Recently played	30 minutes
Game details	24 hours

Use the refresh_library tool to clear the cache immediately (e.g., after buying new games).

Troubleshooting

"Steam returned no library data" Your Steam profile or game library is set to private. Go to Steam → your profile → Edit Profile → Privacy Settings and set both to Public.

"Could not resolve Steam vanity URL" Check that STEAM_ID matches the username in your Steam profile URL (steamcommunity.com/id/YOUR_USERNAME). Alternatively, use your numeric 64-bit Steam ID.

"Could not validate Steam API key" Verify your API key at steamcommunity.com/dev/apikey. Keys are tied to your Steam account login.

Tools not showing in Claude Restart Claude Desktop fully (quit from the system tray, not just close the window) after editing the config file. Check that Node.js 18+ is installed by running node --version in a terminal.

License

MIT