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 "Install 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.
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.
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 mcp add lichess-mcp -- npx -y lichess-mcpRelated MCP server: ChessAgine MCP
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.
Tool | Description |
| Begin OAuth login — opens a browser window |
| Check if you're logged in |
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.) |
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) |
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 |
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 |
"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"
Node.js 18+
A Lichess account
MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Live SEO workflow tools for Claude Code, Codex, and AI agents.
Connect Claude to Fathom meeting recordings, transcripts, and summaries
Read, edit, publish, and preview your pepita websites from Claude.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jamespdaily/lichess-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server