interactive-leetcode-mcp

Interactive LeetCode MCP

Current project is under active development and may not work perfectly

Features

• 🔐 AI-guided authentication - Claude walks you through one-time credential setup
• 🎓 Learning-guided mode - AI provides hints before solutions to maximize learning
• 📝 Solution submission - Submit code and get instant results
• 💬 Conversational workflow - Practice naturally with Claude Code
• 🌍 Multi-language support - Java, Python, C++, JavaScript, TypeScript, and more
• 📊 Detailed feedback - Runtime stats, memory usage, failed test cases
• 📚 Problem data - Descriptions, constraints, examples, editorial solutions
• 👤 User tracking - Profile data, submission history, contest rankings

Prerequisites

• Node.js v20.x or above
• LeetCode account
• Any modern web browser (Chrome, Firefox, Safari, Edge, etc.)

Installation

Via NPM (Recommended)

npm install -g @sperekrestova/interactive-leetcode-mcp

From Source

git clone https://github.com/SPerekrestova/interactive-leetcode-mcp.git
cd interactive-leetcode-mcp
npm install && npm run build
npm link

Configuration

Claude Code & Claude Desktop

You can execute this command in CLI

claude mcp add --transport stdio leetcode -- npx -y @sperekrestova/interactive-leetcode-mcp@latest

Or add to your MCP configuration file (~/.config/claude-code/mcp.json) or (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "leetcode": {
      "command": "npx",
      "args": ["-y", "interactive-leetcode-mcp"]
    }
  }
}

Local build

{
  "mcpServers": {
    "leetcode": {
      "command": "node",
      "args": ["/path/to/this/project/interactive-leetcode-mcp/build/index.js"]
    }
  }
}

Quick Start

1. Authorize with LeetCode

You: "Authorize with LeetCode"
Claude: [Opens LeetCode in your browser and guides you through the process]
Claude: "Please log in to your account. Once logged in, I'll walk you through
        getting two cookie values we need. First, press F12 to open DevTools..."
You: [Follows Claude's step-by-step guidance]
You: "Here are my cookies: csrftoken is abc123... and LEETCODE_SESSION is xyz789..."
Claude: "✓ Perfect! Your credentials are validated and saved. Welcome back, johndoe!"

2. Practice a Problem

You: "I want to practice two-sum"
Claude: [Fetches problem and creates working file]

3. Get Help When Stuck

You: "Give me a hint"
Claude: [Provides contextual guidance based on your code]

4. Submit Your Solution

You: "Submit my solution"
Claude: "🎉 Accepted! Runtime: 2ms (beats 95.3%)"

Available Tools

Authorization

start_leetcode_auth

• Initiates authentication flow
• Opens browser to LeetCode login (when possible)
• Returns structured instructions for AI agent to guide you
• No parameters required

save_leetcode_credentials

• Validates and saves your LeetCode credentials
• Parameters: csrftoken, session (cookie values you provide)
• Makes test API call to verify credentials
• Securely stores credentials for future use

check_auth_status

• Checks if you're authenticated
• Returns username and credential age
• Warns if credentials may expire soon
• No parameters required

Problem Tools

get_daily_challenge

• Fetch today's daily coding challenge

get_problem

• Get detailed problem information by slug
• Parameters: titleSlug (e.g., "two-sum")

search_problems

• Search problems by difficulty, tags, keywords
• Supports filtering and pagination

Submission Tools

submit_solution

• Submit code and get real-time results
• Parameters: problemSlug, code, language
• Returns: acceptance status, runtime, memory, or failed test case

User Tools

get_user_profile

• Retrieve user profile information

get_user_submissions

• Get submission history with filtering

get_user_contest_ranking

• View contest performance and rankings