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

1. Node.js runtime environment
2. (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.

User Tools

Provides user-specific data across both platforms.

Global Site-Specific User Tools

Exclusive to leetcode.com platform.

China Site-Specific User Tools

Exclusive to leetcode.cn platform.

Authenticated Common Tools

Requires session authentication, available on both platforms.

Global Site-Specific Authenticated Tools

Authenticated tools exclusive to leetcode.com.

China Site-Specific Authenticated Tools

Authenticated tools exclusive to leetcode.cn.

Resources

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

Authentication

Advanced features require LeetCode session authentication:

1. Log in to LeetCode (Global or China site)
2. Extract LEETCODE_SESSION cookie from browser developer tools
3. 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.