jkiley129/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.
---
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
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:
---
Local development
To use the local build with Claude Desktop, point the config at the built file:
---
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.