Skip to main content
Glama

BoardGameGeek MCP Server

by attilad

BoardGameGeek MCP Server

This is a Model Context Protocol (MCP) server that integrates with the BoardGameGeek XML API, allowing Claude to search for board games, retrieve game details, get user collections, and more.

Features

This server provides the following tools:

  1. search-games: Search for board games by name
  2. get-game-details: Get detailed information about a specific board game
  3. get-hot-games: Get the current hottest board games on BoardGameGeek
  4. get-user-collection: Get a user's board game collection with filtering options
  5. sync-user-collection: Synchronize a user's collection from BoardGameGeek
  6. get-user-plays: Get a user's recent board game plays
  7. sync-user-plays: Synchronize a user's plays from BoardGameGeek
  8. get-similar-games: Get games similar to a specified game

Feature Checklist

  • Search
  • Get Game Details
  • Hot Games
  • Get User Plays
  • Sync User Plays
  • Get User Collection
  • Sync User Collection
  • Get Similar Games

Prerequisites

  • Node.js 22.5.0 or higher (required for experimental SQLite support)
  • npm (for dependency management)

Building and Running

To build the server:

# Install dependencies npm install # Build the TypeScript code npm run build

To run the server directly:

# The --experimental-sqlite flag is required node --experimental-sqlite build/index.js

To run with Docker:

# Build the Docker image docker build -t bgg-mcp-server . # Run the container docker run --rm -i bgg-mcp-server

Testing

To verify the server is working correctly:

# Make sure the server is built first npm run build # Run the test script with the experimental SQLite flag node --experimental-sqlite test-mcp.js

The test script will:

  1. Start the MCP server
  2. Test the search-games functionality
  3. Test the get-hot-games functionality
  4. Display results and any errors

Using with Claude for Desktop

  1. Open your Claude for Desktop configuration file:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the server configuration for direct Node.js execution:
{ "mcpServers": { "boardgamegeek": { "command": "node", "args": ["--experimental-sqlite", "/path/to/bgg-mcp-server/build/index.js"] } } }
  1. Or use Docker (recommended):
{ "mcpServers": { "boardgamegeek": { "command": "bash", "args": ["-c", "cd /path/to/bgg-mcp-server && docker build -t bgg-mcp-server . && docker run --rm -i -v \"$(pwd)/data:/app/data\" bgg-mcp-server"] } } }

Note: the -v "$(pwd)/data:/app/data" option mounts the local data directory to the /app/data directory in the Docker container, ensuring that the SQLite database is persisted outside the container.

  1. Restart Claude for Desktop

Example Questions

Once connected to Claude, you can ask questions like:

  • "What are the new hot games on boardgamegeek"
  • "Look up the game Molly House on boardgamegeek"

Data Storage

The server uses SQLite for data persistence. All retrieved game data, user collections, and play history are stored in the data/bgg.sqlite database file. This:

  • Reduces API calls to BoardGameGeek
  • Improves response times for repeated queries
  • Maintains data between server restarts

The database is automatically created if it doesn't exist and will be populated as you use the server.

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

An MCP server that integrates with the BoardGameGeek XML API, allowing Claude to search for board games, retrieve game details, and access user collections.

  1. Features
    1. Feature Checklist
  2. Prerequisites
    1. Building and Running
      1. To build the server:
      2. To run the server directly:
      3. To run with Docker:
    2. Testing
      1. Using with Claude for Desktop
        1. Example Questions
          1. Data Storage

            Related MCP Servers

            • -
              security
              F
              license
              -
              quality
              An MCP server for Claude Desktop that allows users to query data from selected Google Cloud datasets by configuring project ID and datasets in the Claude Desktop configuration.
              Last updated -
              Python
              • Apple
            • -
              security
              F
              license
              -
              quality
              An MCP server that integrates with Claude to provide smart documentation search capabilities across multiple AI/ML libraries, allowing users to retrieve and process technical information through natural language queries.
              Last updated -
              Python
            • A
              security
              F
              license
              A
              quality
              An MCP server that allows Claude to interact with Discord by providing tools for sending/reading messages and managing server resources through Discord's API.
              Last updated -
              19
              38
              JavaScript
            • A
              security
              A
              license
              A
              quality
              MCP server that provides Claude AI assistants with the ability to search the web, get news, and perform research using the You.com API.
              Last updated -
              4
              TypeScript
              MIT License
              • Linux
              • Apple

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/attilad/bgg-mcp-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server