Lets agents play games, analyze positions, manage the account and join tournaments on Lichess through natural language.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add lichess --env LICHESS_TOKEN='<LICHESS_TOKEN>' -- npx -y @smithery/cli install @karayaman/lichess-mcp --client claude~/.codex/config.toml
[mcp_servers.lichess]
command = "npx"
args = ["-y", "@smithery/cli", "install", "@karayaman/lichess-mcp", "--client", "claude"]
env = { LICHESS_TOKEN = "<LICHESS_TOKEN>" }
# codex mcp add lichess --env LICHESS_TOKEN='<LICHESS_TOKEN>' -- npx -y @smithery/cli install @karayaman/lichess-mcp --client claude~/.cursor/mcp.json
{
"mcpServers": {
"lichess": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@karayaman/lichess-mcp",
"--client",
"claude"
],
"env": {
"LICHESS_TOKEN": "<LICHESS_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"lichess": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@karayaman/lichess-mcp",
"--client",
"claude"
],
"env": {
"LICHESS_TOKEN": "<LICHESS_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"lichess": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@karayaman/lichess-mcp",
"--client",
"claude"
],
"env": {
"LICHESS_TOKEN": "<LICHESS_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"lichess": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@karayaman/lichess-mcp",
"--client",
"claude"
],
"env": {
"LICHESS_TOKEN": "<LICHESS_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"lichess": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@karayaman/lichess-mcp",
"--client",
"claude"
],
"env": {
"LICHESS_TOKEN": "<LICHESS_TOKEN>"
}
}
}
}Environment variables
LICHESS_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.