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

interactive-leetcode-mcp

Popularity

What's Inside

README