by jinzcdev
An MCP server enabling automated access to LeetCode's problems, solutions, and public data with optional authentication for user-specific features, supporting leetcode.com & leetcode.cn sites.
# Add to your Claude Code skills
git clone https://github.com/jinzcdev/leetcode-mcp-serverGuides for using mcp servers skills like leetcode-mcp-server.
The LeetCode MCP Server is a Model Context Protocol (MCP) server that provides seamless integration with LeetCode APIs, enabling advanced automation and intelligent interaction with LeetCode's programming problems, contests, solutions, and user data.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
To install leetcode-mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @jinzcdev/leetcode-mcp-server --client claude
# Install from npm
npm install @jinzcdev/leetcode-mcp-server -g
# Or run with Global site configuration
npx -y @jinzcdev/leetcode-mcp-server --site global
# Run with authentication (for accessing private data)
npx -y @jinzcdev/leetcode-mcp-server --site global --session <YOUR_LEETCODE_SESSION_COOKIE>
Alternatively, you can clone the repository and run it locally:
# Clone the repository
git clone https://github.com/jinzcdev/leetcode-mcp-server.git
# Navigate to the project directory
cd leetcode-mcp-server
# Build the project
npm install && npm run build
# Run the server
node build/index.js --site global
Add the following JSON configuration to your User Settings (JSON) file. Access this by pressing Ctrl/Cmd + Shift + P and searching for Preferences: Open User Settings (JSON).
{
"mcp": {
"servers": {
"leetcode": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@jinzcdev/leetcode-mcp-server"],
"env": {
"LEETCODE_SITE": "global",
"LEETCODE_SESSION": "<YOUR_LEETCODE_SESSION_COOKIE>"
}
}
}
}
}
{
"mcp": {
"servers": {
"leetcode": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@jinzcdev/leetcode-mcp-server",
"--site",
"global",
"--session",
"<YOUR_LEETCODE_SESSION_COOKIE>"
]
}
}
}
}
For LeetCode China site, modify the --site parameter to cn.
[!TIP]
The server supports the following optional environment variables:
LEETCODE_SITE: LeetCode API endpoint ('global' or 'cn', default: 'global')LEETCODE_SESSION: LeetCode session cookie for authenticated API access (default: empty)Priority Note: Command-line arguments take precedence over environment variables when both are specified. For example:
- If
LEETCODE_SITE=cnis set but you runleetcode-mcp-server --site global, the server will useglobal.- If
LEETCODE_SESSIONexists but you provide--session "new_cookie", the command-line session value will be used.
| Tool | Global | CN | Auth Required | Description | | ----------------------- | :----: | :-: | :-----------: | ------------------------------------------------------------ | | get_daily_challenge | โ | โ | โ | Retrieves today's LeetCode Daily Challenge problem | | get_problem | โ | โ | โ | Retrieves details for a specific LeetCode problem | | search_problems | โ | โ | โ | Searches for LeetCode problems with multiple filter criteria |
| Tool | Global | CN | Auth Required | Description | | --------------------------------- | :----: | :-: | :-----------: | ------------------------------------------------------------ | | get_user_profile | โ | โ | โ | Retrieves profile information for a LeetCode user | | get_user_contest_ranking | โ | โ | โ | Obtains contest ranking statistics for a user | | get_recent_ac_submissions | โ | โ | โ | Retrieves a user's recent accepted submissions | | get_recent_submissions | โ | โ | โ | Retrieves a user's recent submissions history | | get_user_status | โ | โ | โ | Retrieves current user's current status | | get_problem_submission_report | โ | โ | โ | Provides detailed submission analysis for a specific problem | | get_problem_progress | โ | โ | โ | Retrieves current user's problem-solving progress | | get_all_submissions | โ | โ | โ | Retrieves current user's submission history |
| Tool | Global | CN | Auth Required | Description |
| ------------------- | :----: | :-: | :-----------: | ------------------------------------------------------------- |
| run_code | โ
| โ
| โ
| Runs code for a problem and polls /check/ until finished |
| submit_solution | โ
| โ
| โ
| Submits code for a problem and polls /check/ until finished |
| Tool | Global | CN | Auth Required | Description | | ---------------- | :----: | :-: | :-----------: | ----------------------------------------------------- | | search_notes | โ | โ | โ | Searches for user notes with filtering options | | get_note | โ | โ | โ | Retrieves notes for a specific problem by question ID | | create_note | โ | โ | โ | Creates a new note for a specific problem | | update_note | โ | โ | โ | Updates an existing note with new content |
| Tool | Global | CN | Auth Required | Description | | -------------------------- | :----: | :-: | :-----------: | -------------------------------------------------------------- | | list_problem_solutions | โ | โ | โ | Retrieves a list of community solutions for a specific problem | | get_problem_solution | โ | โ | โ | Retrieves the complete content of a specific solution |
get_daily_challenge - Retrieves today's LeetCode Daily Challenge problem with complete details
get_problem - Retrieves details about a specific LeetCode problem
titleSlug: The URL slug/identifier of the problem (string, required)search_problems - Searches for LeetCode problems based on multiple filter criteria
category: Problem category filter (string, optional, default: "all-code-essentials")tags: List of topic tags to filter problems by (string[], optional)difficulty: Problem difficulty level filter (enum: "EASY", "MEDIUM", "HARD", optional)searchKeywords: Keywords to search in problem titles and descriptions (string, optional)limit: Maximum number of problems to return (number, optional, default: 10)offset: Number of problems to skip (number, optional)get_user_profile - Retrieves profile information about a LeetCode user
username: LeetCode username (string, required)get_user_contest_ranking - Retrieves a user's contest ranking information
username: LeetCode username (string, required)attended: Whether to include only the contests the user has participated in (boolean, optional, default: true)get_recent_submissions - Retrieves a user's recent submissions on LeetCode Global
username: LeetCode username (string, required)limit: Maximum number of submissions to return (number, optional, default: 10)get_recent_ac_submissions - Retrieves a user's recent accepted submissions
username: LeetCode username (string, required)limit: Maximum number of submissions to return (number, optional, default: 10)get_user_status - Retrieves the current user's status
get_problem_submission_report - Retrieves detailed informat