Lichess MCP
Provides tools for playing chess games, analyzing positions with cloud Stockfish evaluation, solving puzzles, and managing Lichess account activities. Supports creating challenges, making moves in UCI notation, streaming live game states, offering draws, and retrieving user profiles and game history.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Lichess MCP What's my current blitz rating?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpRelated 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 |
| Begin OAuth login — opens a browser window |
| Check if you're logged in |
Account & Users
Tool | Description |
| Your ratings and account stats |
| Any player's public profile |
| Your recent game history (filter by color, rated/casual) |
| Rating history over time for any player |
| Head-to-head record between two players |
| Top players by time control (bullet, blitz, rapid, etc.) |
Challenges
Tool | Description |
| List your incoming and outgoing challenges |
| Accept an incoming challenge |
| Decline a challenge (with optional reason) |
| Cancel a challenge you sent |
| Challenge a specific player |
| Play against Stockfish AI (levels 1–8) |
Games
Tool | Description |
| List your active games |
| Play a move (UCI notation, e.g. |
| Get live board state for a game |
| Stream incoming events (challenges, game starts) |
| Abort a game in its early moves |
| Resign a game |
| Offer, accept, or decline a draw |
| Request, accept, or decline a takeback |
| Send a chat message in a game |
Puzzles & Analysis
Tool | Description |
| Today's Lichess puzzle |
| A specific puzzle by ID |
| Your next recommended puzzle |
| Your recent puzzle history and results |
| 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
Node.js 18+
A Lichess account
License
MIT
Available Tools
28 toolslichess_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
Scored across 28 tools
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.
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.
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.
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
Related MCP Connectors
Chess MCP for Claude: engine analysis, attack maps, game review. One URL, no install.
Lichess MCP server for ChatGPT, Claude and any AI agent: accept team join request, send team update, create Arena tournament, create broadcast, import PGN to study and export games in your own Lichess account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Lichess yourself; Cotlet does not store your password and you need no Lichess API key. About the official Lichess API: Lichess has a full, free REST API with personal and OAuth tokens, but no official MCP server (checked 17 Oct 2026). The API covers teams, Arena and Swiss tournaments, studies, broadcasts, challenges and game export, so the gap is a hosted, maintained MCP with no token to create, scope or revoke. Setup and FAQ: https://cotlet.dev/integrations/lichess-api-mcp-server
Lichess MCP — public read-only API for users, games, explorer, tablebase.
Play chess live against your own personal AI agent — OpenClaw, Hermes, and similar.
Related MCP Servers
- AlicenseCqualityBmaintenanceAn 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.9028 npm20MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.34AGPL 3.0
- AlicenseNot gradedqualityDmaintenanceEnables 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 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables 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 npm2MIT