BGG MCP
BGG MCP gives an assistant BoardGameGeek data: game details, collections, store prices, recommendations and rules answers
- 60 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The server reads public BoardGameGeek data and uses your API key, which sits in the client configuration
Install
- Works in
Manual install
{"bgg":{"command":"docker","args":["run","-i","--rm","--pull=always","-e","BGG_API_KEY","-e","BGG_USERNAME","kdaniel/bgg-mcp"],"env":{"BGG_API_KEY":"your_api_key_here","BGG_USERNAME":"your_bgg_username"}}}The image is published on Docker Hub.
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The server reads public BoardGameGeek data and uses your API key, which sits in the client configuration
This is third-party code. Review the repository files before installing.
What it does
BGG MCP is a Go server for the BoardGameGeek API. Ten tools search games, return details with best player counts and rank, read user collections, list the hot games, compare retailer prices through BoardGamePrices.co.uk and suggest similar games through Recommend.Games. A separate `bgg-rules` tool looks for the most relevant threads in a game's rules forum and `bgg-thread-details` returns a whole thread. Resources such as `bgg://hotness` and `bgg://my-collection` exist when `BGG_USERNAME` is set, along with ready prompts. Answers link back to boardgamegeek.com pages.
Who it is for. Board game fans and reviewers who ask Claude about games, rules and prices.
Good fit when
- You need to pick a five-player game from your collection by playtime and rating
- It is unclear whether pink powers fire on your own turn in Wingspan and you want an answer from the rules forum
- Prices for a game by BGG ID have to be compared across retailers
- Two players need trade options based on their collections
Not a fit when
- You need a game's full rules as the publisher's official text
- The game is not listed on BoardGameGeek
- You need access with no BoardGameGeek API key
Example request
Which games in my collection suit five players and take under an hour? Check the bank trade rules in CatanMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
BGG_API_KEYrequired, secret- BoardGameGeek API key
BGG_USERNAME- BGG username for a personal collection
Limitations
Most tools need a BoardGameGeek API key, set through the `BGG_API_KEY` variable or in the extension install dialog. Prices come from BoardGamePrices.co.uk and recommendations from Recommend.Games, so answer completeness depends on those services. Building from source requires Go. The server only reads data and changes nothing in your BoardGameGeek profile. Updates are checked at launch and the check can be turned off with the `BGG_DISABLE_UPDATE_CHECK` variable.
How to disable. Remove the extension in Claude Desktop or the `bgg` entry from the client configuration. The API key can be revoked on the BoardGameGeek site.
FAQ
How do I install BGG MCP in Claude Desktop?
Download `bgg-mcp.mcpb` from the latest release and open it, then enter the API key in the dialog. Smithery and Docker routes exist too.
How do I run the server in Docker?
Add the command `docker run -i --rm --pull=always -e BGG_API_KEY -e BGG_USERNAME kdaniel/bgg-mcp` to the configuration with the environment variables.
What is bgg-rules?
The tool searches a game's rules forum for the threads closest to a question, and `bgg-thread-details` opens the chosen thread with all posts.
Where do prices come from?
From BoardGamePrices.co.uk, which collects offers from several retailers. The `bgg-price` tool takes BGG identifiers.
Is a username required?
It is optional, but with `BGG_USERNAME` the `bgg://my-collection` resource appears and prompts no longer need the name repeated.
Discussion
No questions or reviews yet.
Related
MCP serversmcp-gsheets reads and edits Google Sheets through a service account: values, formatting, charts and native tables.
RollingGo Hotel MCP: hotel search and booking
RollingGo Hotel MCP
Official RollingGo MCP server: worldwide hotel search, price comparison and hotel details for Claude Code, Cursor and Codex agents
Google Docs MCP: Docs, Sheets, Drive, Gmail and Calendar
Google Docs MCP
An MCP server giving an agent Google Docs, Sheets, Drive, Gmail, Calendar and Apps Script: reading, editing, mail and events; sign-in over OAuth
Trello MCP server with 57 tools: cards, lists, checklists, attachments, comments, custom fields and workspaces, plus acceptance-criteria extraction
The official Kibela MCP server searches, reads and edits notes, folders and comments of your wiki straight from an assistant chat
LLM Wiki MCP gives an agent the LLM Wiki app knowledge base: search, page reading, a link graph and source-grounded chat.
README in short
The README presents the server as access to BoardGameGeek data and lists tools, resources and prompts. Installation is covered for the Claude Desktop extension, Smithery, Docker and a Go build, with the API key described separately.