lichess-mcp

A Model Context Protocol (MCP) server that connects Claude to Lichess. Play chess, analyze positions, solve puzzles, and manage your games — 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

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

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

Games

Tool	Description
`lichess_get_ongoing_games`	List your active games
`lichess_create_challenge`	Challenge a player to a game
`lichess_make_move`	Play a move (UCI notation, e.g. `e2e4`)
`lichess_stream_game`	Get live board state for a game
`lichess_resign`	Resign a game
`lichess_offer_draw`	Offer, accept, or decline a draw

Puzzles & Analysis

Tool	Description
`lichess_get_daily_puzzle`	Today's Lichess puzzle
`lichess_get_puzzle`	A specific puzzle by ID
`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"
"What's the best move in this position: rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1"
"Get today's puzzle"
"Resign my current game"

Requirements

Node.js 18+
A Lichess account

License

MIT

Lichess MCP