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.

Features

Multi-site Support: Supports both leetcode.com and leetcode.cn platforms
Problem Data Retrieval: Obtain detailed problem descriptions, constraints, examples, and solution approaches
User Data Access: Retrieve user profiles, submission history, and contest performance
Advanced Search Capabilities: Filter problems by tags, difficulty levels, and categories
Daily Challenge Tracking: Easily access daily challenge problems

Prerequisites

Node.js runtime environment
(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 and run the server
npm run build && node build/index.js --site global

Usage

Visual Studio Code Integration

Add the following JSON configuration to your User Settings (JSON) file Code. 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",
          "--site",
          "global",
          "--session",
          "<YOUR_LEETCODE_SESSION_COOKIE>"
        ]
      }
    }
  }
}

For LeetCode China site, modify the --site parameter to cn.

Environment Variables

The server supports the following environment variables:

LEETCODE_SITE: LeetCode API endpoint ('global' or 'cn')
LEETCODE_SESSION: LeetCode session cookie for authenticated API access

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.

Tools

The server provides a comprehensive suite of tools categorized by functionality and platform compatibility.

Problem Tools

Available on both Global and China sites, with optional authentication.

Tool Name	Description	Parameters
leetcode_daily_challenge	Retrieves today's LeetCode Daily Challenge with complete metadata	None
leetcode_problem	Retrieves comprehensive details for a specified LeetCode problem	`titleSlug` (string, required): Problem URL identifier (e.g., 'two-sum')
leetcode_search_problems	Executes filtered searches across LeetCode problems	`category` (string, optional): Problem classification`tags` (string[], optional): Topic tags filter`difficulty` (string, optional): Problem complexity level ('EASY', 'MEDIUM', 'HARD')`limit` (number, optional): Maximum results count`offset` (number, optional): Pagination offset

Tool Name	Description	Parameters
leetcode_user_profile	Retrieves complete profile information for a LeetCode user	`username` (string, required): LeetCode username
leetcode_user_contest_ranking	Obtains contest ranking statistics for a user	`username` (string, required): LeetCode username`attended` (boolean, optional): Filter for attended contests only

Global Site-Specific User Tools

Exclusive to leetcode.com platform.

Tool Name	Description	Parameters
leetcode_recent_submissions	Retrieves a user's recent submission history (Global)	`username` (string, required): LeetCode username`limit` (number, optional): Results limit
leetcode_recent_ac_submissions	Retrieves a user's recent accepted submissions (Global)	`username` (string, required): LeetCode username`limit` (number, optional): Results limit

China Site-Specific User Tools

Exclusive to leetcode.cn platform.

Tool Name	Description	Parameters
leetcode_user_recent_ac_submissions	Retrieves recent accepted submissions (China)	`username` (string, required): LeetCode China username`limit` (number, optional): Results limit

Authenticated Common Tools

Requires session authentication, available on both platforms.

Tool Name	Description	Parameters
leetcode_user_status	Retrieves authenticated user's current status	None
leetcode_problem_submission_detail	Provides detailed submission analysis	`id` (number, required): Submission ID
leetcode_user_progress_questions	Tracks user's problem-solving progress	`offset` (number, required): Pagination offset`limit` (number, required): Results limit`questionStatus` (enum, optional): 'ATTEMPTED' or 'SOLVED' filter`difficulty` (string[], optional): Complexity level filter

Global Site-Specific Authenticated Tools

Authenticated tools exclusive to leetcode.com.

Name	Description	Parameters
leetcode_user_all_submissions	Retrieves paginated submission history (Global)	`limit` (number, required): Results limit`offset` (number, required): Pagination offset`questionSlug` (string, optional): Problem identifier filter

China Site-Specific Authenticated Tools

Authenticated tools exclusive to leetcode.cn.

Tool Name	Description	Parameters
leetcode_user_all_submissions	Retrieves comprehensive submission history (China)	`limit` (number, required): Results limit`offset` (number, required): Pagination offset`questionSlug` (string, optional): Problem identifier`lang` (string, optional): Programming language filter`status` (string, optional): Submission status filter`lastKey` (string, optional): Pagination token

Resources

The server provides reference resources for platform metadata access via URI endpoints.

Resource Name	Description	URI
problem-categories	Complete problem classification categories	`leetcode://problems/categories/all`
problem-tags	Algorithmic and data structure tags collection	`leetcode://problems/tags/all`
problem-langs	Supported programming languages list	`leetcode://problems/langs/all`
solution-article	A LeetCode solution article	global: `leetcode://solutions/{topicId}`cn: `leetcode://solutions/{slug}`

Authentication

Advanced features require LeetCode session authentication:

Log in to LeetCode (Global or China site)
Extract LEETCODE_SESSION cookie from browser developer tools
Configure server with --session flag or LEETCODE_SESSION environment variable

Response Format

All tools return JSON-formatted responses with the following structure:

{
  "content": [
    {
      "type": "text",
      "text": "JSON_DATA_STRING"
    }
  ]
}

The JSON_DATA_STRING contains either the requested data or an error message for failed requests.

License

This project is licensed under the MIT License.

Integrations