Skip to main content
Glama
Lichess MCP

Lichess MCP

by jamespdaily

lichess-mcp

A Model Context Protocol (MCP) server that connects Claude to Lichess. Play chess, analyze positions, solve puzzles, manage challenges, and explore stats — all from Claude.

Installation

Claude Desktop

Add the following to your Claude Desktop config:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "lichess-mcp": {
      "command": "npx",
      "args": ["-y", "lichess-mcp"]
    }
  }
}

Restart Claude Desktop after saving.

Claude Code

claude mcp add lichess-mcp -- npx -y lichess-mcp

Related MCP server: ChessAgine MCP

Authentication

After installation, ask Claude to "start Lichess auth". A browser window will open for you to authorize the app with your Lichess account. Your token is cached locally at ~/.lichess-mcp-auth/token.json and reused automatically on future sessions.

Tools

Auth

Tool

Description

lichess_auth_start

Begin OAuth login — opens a browser window

lichess_auth_status

Check if you're logged in

Account & Users

Tool

Description

lichess_get_my_profile

Your ratings and account stats

lichess_get_user

Any player's public profile

lichess_get_my_games

Your recent game history (filter by color, rated/casual)

lichess_get_rating_history

Rating history over time for any player

lichess_get_crosstable

Head-to-head record between two players

lichess_get_leaderboard

Top players by time control (bullet, blitz, rapid, etc.)

Challenges

Tool

Description

lichess_list_challenges

List your incoming and outgoing challenges

lichess_accept_challenge

Accept an incoming challenge

lichess_decline_challenge

Decline a challenge (with optional reason)

lichess_cancel_challenge

Cancel a challenge you sent

lichess_create_challenge

Challenge a specific player

lichess_challenge_ai

Play against Stockfish AI (levels 1–8)

Games

Tool

Description

lichess_get_ongoing_games

List your active games

lichess_make_move

Play a move (UCI notation, e.g. e2e4)

lichess_stream_game

Get live board state for a game

lichess_stream_events

Stream incoming events (challenges, game starts)

lichess_abort

Abort a game in its early moves

lichess_resign

Resign a game

lichess_offer_draw

Offer, accept, or decline a draw

lichess_takeback

Request, accept, or decline a takeback

lichess_send_chat

Send a chat message in a game

Puzzles & Analysis

Tool

Description

lichess_get_daily_puzzle

Today's Lichess puzzle

lichess_get_puzzle

A specific puzzle by ID

lichess_get_next_puzzle

Your next recommended puzzle

lichess_get_puzzle_activity

Your recent puzzle history and results

lichess_cloud_eval

Stockfish cloud evaluation for a FEN position

Example prompts

  • "What's my current blitz rating?"

  • "Show me my last 5 games as white"

  • "Challenge @DrNykterstein to a 5+3 rated game"

  • "Start a game against Stockfish level 5, 10 minutes, I'll play white"

  • "List my incoming challenges"

  • "Accept challenge abc123"

  • "What's the head-to-head record between Magnus and Hikaru?"

  • "Show me the top 10 bullet players"

  • "What's today's puzzle?"

  • "Get my next puzzle"

  • "Show my puzzle activity for the last 50 attempts"

  • "What's the best move in this position: rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1"

  • "Resign my current game"

  • "Send 'good luck' to my opponent in game xyz"

Requirements

License

MIT

Available Tools

28 tools
lichess_abortA

Abort an active Lichess chess game before it has started properly. Only works in the first few moves.

Inputs: gameId (required).

lichess_accept_challengeC

Accept an incoming chess challenge on Lichess. Start the game with the challenger.

Inputs: challengeId (required).

lichess_auth_startA

Start the Lichess OAuth login flow. Opens a browser for authorization. Use this to connect, sign in, or authenticate your Lichess chess account.

Inputs: no named parameters.

lichess_auth_statusA

Check if you are authenticated with Lichess and return account info. Use this to verify login status or confirm which Lichess chess account is connected.

Inputs: no named parameters.

lichess_cancel_challengeA

Cancel an outgoing chess challenge you sent on Lichess.

Inputs: challengeId (required).

lichess_challenge_aiA

Challenge the Lichess AI (Stockfish) to a chess game. Choose difficulty level 1–8, time control, color, and variant.

Inputs: level (required), clockLimit (required), clockIncrement (required), color, +1 more.

lichess_cloud_evalA

Get Lichess cloud engine evaluation for a chess position in FEN notation. Returns the best move, score, and top lines from Stockfish cloud analysis.

Inputs: fen (required), multiPV.

lichess_create_challengeA

Challenge a Lichess player to a chess game. Send a game invite with custom time control (bullet, blitz, rapid, classical, correspondence), color choice, and rated or casual.

Inputs: username (required), clockLimit (required), clockIncrement (required), color, +1 more.

lichess_decline_challengeB

Decline an incoming chess challenge on Lichess. Optionally provide a reason.

Inputs: challengeId (required), reason.

lichess_get_crosstableA

Get the head-to-head record between two Lichess players. Shows total games and score for each player.

Inputs: user1 (required), user2 (required).

lichess_get_daily_puzzleA

Get today's Lichess daily chess puzzle. Returns the position, solution, and puzzle metadata for the puzzle of the day.

Inputs: no named parameters.

lichess_get_leaderboardA

Get the Lichess leaderboard — top players by rating for a specific time control (bullet, blitz, rapid, classical, chess960, etc.).

Inputs: nb, perfType.

lichess_get_my_gamesA

Fetch your recent chess games from Lichess. Returns game history including moves, result, opponent, time control, and opening. Filter by color (white/black) or rated/casual.

Inputs: max, color, rated.

lichess_get_my_profileA

Get your Lichess account profile, ratings, and stats. Returns your chess rating, username, and performance across bullet, blitz, rapid, and classical time controls.

Inputs: no named parameters.

lichess_get_next_puzzleB

Get your next recommended Lichess chess puzzle based on your puzzle rating and history.

Inputs: no named parameters.

lichess_get_ongoing_gamesA

Get your currently active or in-progress chess games on Lichess. Lists all games you are currently playing, including board position and whose turn it is.

Inputs: no named parameters.

lichess_get_puzzleA

Get a specific Lichess chess puzzle by ID. Returns the board position, moves, theme, and difficulty rating for the puzzle.

Inputs: id (required).

lichess_get_puzzle_activityA

Get your Lichess puzzle activity history — recent puzzles you attempted, results, ratings, and themes.

Inputs: max.

lichess_get_rating_historyB

Get the chess rating history over time for a Lichess player across all time controls (bullet, blitz, rapid, classical, etc.).

Inputs: username (required).

lichess_get_userA

Get a Lichess user's public chess profile, ratings, and stats by username. Look up any player on Lichess.

Inputs: username (required).

lichess_list_challengesA

List your incoming and outgoing chess challenges on Lichess. See pending game invites you have received or sent.

Inputs: no named parameters.

lichess_make_moveA

Play a chess move in an active Lichess game using UCI notation (e.g. e2e4, d7d5, e7e8q for promotion). Submit your move during a live game.

Inputs: gameId (required), move (required).

lichess_offer_drawA

Offer, accept, or decline a draw in an active Lichess chess game. Propose a draw to your opponent or respond to their draw offer.

Inputs: gameId (required), accept (required).

lichess_resignA

Resign and forfeit an active Lichess chess game. Concedes the game to your opponent.

Inputs: gameId (required).

lichess_send_chatC

Send a chat message in an active Lichess chess game, to the player or spectator chat room.

Inputs: gameId (required), text (required), room.

lichess_stream_eventsA

Stream incoming Lichess events such as game starts, incoming challenges, and correspondence game moves.

Inputs: no named parameters.

lichess_stream_gameA

Stream the live board state, moves, and game events for an ongoing Lichess chess game. Get real-time updates including position, clocks, and chat.

Inputs: gameId (required).

lichess_takebackB

Request, accept, or decline a takeback (undo last move) in an active Lichess chess game.

Inputs: gameId (required), accept (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 28 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose targeting specific actions within the Lichess chess platform, such as game management (abort, resign, make_move), challenge handling (accept, decline, create), and data retrieval (get_user, get_leaderboard). There is no overlap or ambiguity; each tool's function is well-defined and non-redundant.

    Naming Consistency5/5

    All tools follow a consistent 'lichess_verb_noun' naming pattern with snake_case, such as lichess_accept_challenge and lichess_get_leaderboard. This uniformity makes the tool set predictable and easy to navigate, with no deviations in style or structure.

    Tool Count3/5

    With 28 tools, the count is borderline high for a chess server, potentially overwhelming for an agent. While it covers many aspects of Lichess, some tools could be consolidated (e.g., multiple puzzle-related tools), making the set feel slightly heavy and less streamlined.

    Completeness5/5

    The tool set provides comprehensive coverage of the Lichess chess domain, including authentication, game lifecycle (create, move, resign), challenges, puzzles, user data, and real-time streaming. There are no obvious gaps; it supports full CRUD and interactive operations for chess gameplay and account management.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      An MCP server that enables natural language interaction with the Lichess chess platform, allowing users to play games, analyze positions, manage their account, and participate in tournaments through Claude.
      90
      28 npm
      20
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables comprehensive chess analysis through Stockfish engine integration, positional evaluation, puzzle training, game review, and access to extensive chess databases. Provides visual board rendering, interactive game viewers, and tactical puzzle training with 3+ million problems from Lichess.
      34
      AGPL 3.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables natural language interaction with Lichess chess platform to play games, analyze positions, manage challenges and tournaments, and interact with other players through Claude Desktop.
      28 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to perform professional-grade chess analysis using Stockfish and optionally Leela Chess Zero, including position analysis, full game review, opening lookup, and puzzle generation.
      12 npm
      2
      MIT