← Back to directory
B

BoardGameGeek MCP Server

Community
Access BoardGameGeek data via the Model Context Protocol
GitHub source repository ↗
★ 52 Stars Category · Other Popular Source revision 1a52a319e8cc
52FMRS · D
Reliability
8/20
Security and permissions
10/20
Maintenance
10/20
Documentation
12/20
Setup experience
12/20

This server provides a convenient toolset for board game enthusiasts, but requires BGG authentication for most features. The user interface is friendly and documentation is clear, making it suitable for integration into AI assistant workflows.

Read the FMRS scoring method →

BGG MCP is an MCP server providing access to the BoardGameGeek API, enabling retrieval and filtering of board game data, user collections, and profiles. The server is implemented in Go using the GoGeek library. Price data is provided by BoardGamePrices.co.uk, and game recommendations are powered by Recommend.Games.

Tools

bgg-search
Search for board games with type filtering (base games, expansions, or all)
bgg-details
Get detailed information about a specific board game
bgg-collection
Query and filter a user's game collection with extensive filtering options
bgg-hot
Get the current BGG hotness list
bgg-user
Get user profile information
bgg-price
Get current prices from multiple retailers using BGG IDs
bgg-trade-finder
Find trading opportunities between two BGG users
bgg-recommender
Get game recommendations based on similarity to a specific game
bgg-thread-details
Get the full content of a specific BGG forum thread including all posts
bgg-rules
Answer rules questions by searching BGG forums (experimental)

Setup

Recommended to install via Docker: add the configuration above to your Claude Desktop or VS Code settings. Alternatively, build manually: install Go, run make build, and configure the resulting binary as the command. Ensure you set BGG_API_KEY or BGG_COOKIE for authentication.

claude_desktop_config.json
{
  "bgg": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "-e", "BGG_API_KEY", "-e", "BGG_USERNAME", "kdaniel/bgg-mcp"],
    "env": {
      "BGG_API_KEY": "your_api_key_here",
      "BGG_USERNAME": "your_bgg_username"
    }
  }
}

Fit and risk

Best for

  • Board game enthusiasts
  • Developers needing quick access to BGG data
  • Users who want to manage their game collection via AI assistants

Not for

  • Users who don't need BGG data or board game information
  • Users who prefer direct BGG API access without an MCP layer

Required permissions

  • Requires reading user's BGG collection and profile (needs BGG_USERNAME)
  • Supports authentication via BGG_API_KEY or BGG_COOKIE

Risks and side effects

  • Requires BGG API key or cookie, which could be misused if leaked
  • Price data from third-party may be incomplete or inaccurate
  • Depends on external services (BGG, BoardGamePrices, Recommend.Games), may be unavailable due to network issues

Troubleshooting

  1. Check that BGG_API_KEY or BGG_COOKIE is set correctly
  2. Ensure network connectivity to BGG and external services
  3. If using Docker, confirm the image is pulled and running
  4. Verify the configuration file paths and commands are correct

Use cases

Query board game information and ratings
Manage your BGG collection
Get the current hot games on BGG
Compare prices from multiple retailers
Find similar game recommendations
Generate trade sale posts

Supported clients

Claude DesktopFull support