export_user_games

Export a user’s chess games from Lichess with customizable filters, including game type, analysis, moves, and timeframes, for detailed review or analysis.

Instructions

Export all games of a user

Input Schema

Name	Required	Description	Default
`accuracy`	No	Include accuracy
`analysed`	No	Only games with or without computer analysis
`clocks`	No	Include clock comments
`color`	No	Only games played as this color
`evals`	No	Include analysis
`finished`	No	Include finished games
`lastFen`	No	Include last position FEN
`literate`	No	Include textual annotations
`max`	No	Maximum number of games to download
`moves`	No	Include moves
`ongoing`	No	Include ongoing games
`opening`	No	Include opening
`perfType`	No	Only games in these speeds or variants
`rated`	No	Only rated (true) or casual (false) games
`since`	No	Download games played since timestamp
`sort`	No	Sort order of games	dateDesc
`tags`	No	Include tags
`until`	No	Download games played until timestamp
`username`	Yes	The username
`vs`	No	Only games against this opponent

Input Schema (JSON Schema)

{
  "properties": {
    "accuracy": {
      "default": false,
      "description": "Include accuracy",
      "type": "boolean"
    },
    "analysed": {
      "description": "Only games with or without computer analysis",
      "type": "boolean"
    },
    "clocks": {
      "default": false,
      "description": "Include clock comments",
      "type": "boolean"
    },
    "color": {
      "description": "Only games played as this color",
      "enum": [
        "white",
        "black"
      ],
      "type": "string"
    },
    "evals": {
      "default": false,
      "description": "Include analysis",
      "type": "boolean"
    },
    "finished": {
      "default": true,
      "description": "Include finished games",
      "type": "boolean"
    },
    "lastFen": {
      "default": false,
      "description": "Include last position FEN",
      "type": "boolean"
    },
    "literate": {
      "default": false,
      "description": "Include textual annotations",
      "type": "boolean"
    },
    "max": {
      "description": "Maximum number of games to download",
      "type": "number"
    },
    "moves": {
      "default": true,
      "description": "Include moves",
      "type": "boolean"
    },
    "ongoing": {
      "default": false,
      "description": "Include ongoing games",
      "type": "boolean"
    },
    "opening": {
      "default": false,
      "description": "Include opening",
      "type": "boolean"
    },
    "perfType": {
      "description": "Only games in these speeds or variants",
      "enum": [
        "ultraBullet",
        "bullet",
        "blitz",
        "rapid",
        "classical",
        "correspondence",
        "chess960",
        "crazyhouse",
        "antichess",
        "atomic",
        "horde",
        "kingOfTheHill",
        "racingKings",
        "threeCheck"
      ],
      "type": "string"
    },
    "rated": {
      "description": "Only rated (true) or casual (false) games",
      "type": "boolean"
    },
    "since": {
      "description": "Download games played since timestamp",
      "type": "number"
    },
    "sort": {
      "default": "dateDesc",
      "description": "Sort order of games",
      "enum": [
        "dateAsc",
        "dateDesc"
      ],
      "type": "string"
    },
    "tags": {
      "default": true,
      "description": "Include tags",
      "type": "boolean"
    },
    "until": {
      "description": "Download games played until timestamp",
      "type": "number"
    },
    "username": {
      "description": "The username",
      "type": "string"
    },
    "vs": {
      "description": "Only games against this opponent",
      "type": "string"
    }
  },
  "required": [
    "username"
  ],
  "type": "object"
}

Lichess MCP

export_user_games

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Lichess MCP

Related Tools

MCP directory API