Advertise
MCP.so
Sign In

Lichess MCP Server

@karayaman

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

karayaman

About Lichess MCP Server

A Model Context Protocol (MCP) server that enables Claude Desktop to interact with Lichess chess platform through natural language. Play games, analyze positions, manage your account, and participate in tournaments—all by simply talking to Claude.

#ai#mcp#lichess-api#lichess#mcp-server

Lichess MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "lichess-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@karayaman/lichess-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Lichess MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Lichess MCP?

Lichess MCP is a Model Context Protocol server that lets you interact with the Lichess chess platform using natural language. Built for Claude Desktop and other MCP clients, it enables account management, game play, analysis, tournaments, and more through a set of tools.

How to use Lichess MCP?

Install globally via npm (npm install -g lichess-mcp) or use Smithery (npx -y @smithery/cli install @karayaman/lichess-mcp --client claude). Configure a Lichess API token via environment variable LICHESS_TOKEN or the set_token tool, then add the server to your Claude Desktop config under mcpServers.

Key features of Lichess MCP

  • Manage your Lichess account and view profiles
  • Create challenges, make moves, and manage games
  • Analyze positions with cloud evaluations and PGN export
  • Join and create arena tournaments
  • Interactive chess UIs: puzzles, game viewer, opening explorer (in supported clients)

Use cases of Lichess MCP

  • Ask Claude to show your Lichess profile or ongoing games
  • Start a new chess game with a specific time control via a chat command
  • Get cloud evaluation for a position from a FEN string
  • Join or create an arena tournament without leaving the desktop
  • Step through a Lichess game or PGN interactively in the chat

Frequently asked questions

1

How do I get a Lichess API token?

Generate one at https://lichess.org/account/oauth/token. Provide it via the `LICHESS_TOKEN` environment variable or the `set_token` tool during runtime.

2

What move formats does the server accept?

The API accepts moves in UCI format (e.g., `e2e4`) for most endpoints, and SAN format (e.g., `e4`) for some endpoints.

3

Can I use the server without Claude Desktop?

Yes. After building (`npm run build`), you can start the server standalone with `npm start`. It works with any MCP client.

4

Is there interactive visual feedback for chess boards?

In clients that support MCP Apps (like Claude Desktop), certain tools (`play_puzzle`, `view_pgn`, `explore_openings`) render an interactive chess board. In other clients, they fall back to text (FEN/PGN/Lichess links).

5

What should I do if the server won't connect?

Ensure `lichess-mcp` is installed globally and available in your PATH, check the configuration file uses the `mcpServers` format (not `mcp_servers`), and verify your Lichess API token is valid. Restart Claude Desktop completely after changes.

Comments

More Other MCP servers

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Advertise