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.
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.
Features
๐ Multi-site Support: Supportโ both leetcode.com (Global) and leetcode.cn (China) platforms
๐ Problem Data Retrieval: Obtain detailed problem descriptions, constraints, examples, official editorials, and โuser-submitted solutions
๐ค User Data Access: Retrieve user profiles, submission history, and contest performance
๐ โPrivate Data Access: Create and query user notes, track problem-solving progress, and analyze submission details (AC/WA analysis)
๐ Advanced Search Capabilities: Filter problems by tags, difficulty levels, categories, and keywords
(Optional) LeetCode session cookie for authenticated API access
Installation
Installing via Smithery
To install leetcode-mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @jinzcdev/leetcode-mcp-server --client claude
Manual Installation
# 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
Usage
Visual Studio Code Integration
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).
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=cn is set but you run leetcode-mcp-server --site global, the server will use global.
If LEETCODE_SESSION exists but you provide --session "new_cookie", the command-line session value will be used.
Available Tools
Problems
| 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 |
Users
| 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 |
Submissions
| 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 |
Notes
| 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 |
Solutions
| 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 |
Tool Parameters
Problems
get_daily_challenge - Retrieves today's LeetCode Daily Challenge problem with complete details
No parameters required
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)
Users
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
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
A Claude Code plugin that automatically captures everything Claude does during your coding sessions, compresses it with AI (using Claude's agent-sdk), and injects relevant context back into future sessions.
