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
MCP server

Minimal access

Why this level

  • The server reads public BoardGameGeek data and uses your API key, which sits in the client configuration
All reasons and checks

kkjdaniel/bgg-mcp

Install

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 review

Minimal 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 Catan

MCP

Transport
stdio
Authentication
API key

Environment variables

BGG_API_KEY required, 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.

mcp-gsheets reads and edits Google Sheets through a service account: values, formatting, charts and native tables.

MCP serverExtended access105Repository stars
Official

Official RollingGo MCP server: worldwide hotel search, price comparison and hotel details for Claude Code, Cursor and Codex agents

MCP serverExtended access89Repository stars

Trello MCP server with 57 tools: cards, lists, checklists, attachments, comments, custom fields and workspaces, plus acceptance-criteria extraction

MCP serverBroad access447Repository stars
Official

The official Kibela MCP server searches, reads and edits notes, folders and comments of your wiki straight from an assistant chat

MCP serverExtended access16Repository stars

LLM Wiki MCP gives an agent the LLM Wiki app knowledge base: search, page reading, a link graph and source-grounded chat.

MCP serverMinimal access21.6KRepository stars

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.

README badge

Report a problem