Interactive Leetcode MCP README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Interactive Leetcode MCP listing page.
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)
You can also run the package without installing it globally:
From Source
Fresh Environment Smoke Test
Use this to verify the published npm package from a clean directory without any LeetCode credentials:
Those commands confirm that Node can install the package and expose the CLI binary. For actual MCP server validation, use an integration test that connects over stdio and completes the MCP handshake.
Configuration
Claude Code & Claude Desktop
You can execute this command in CLI
Or add to your MCP configuration file (~/.config/claude-code/mcp.json) or (~/Library/Application Support/Claude/claude_desktop_config.json):
Local build
Quick Start
1. Authorize with LeetCode
2. Practice a Problem
3. Get Help When Stuck
4. Submit Your Solution
Available Tools
Getting Started
get_started
- Returns the server usage guide, learning flow, authentication flow, and submission language map
- Call this at the start of a LeetCode practice session
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
Session and Learning Tools
start_problem
- Opens or resumes a tutoring session for a problem
- Parameters:
titleSlug, optionallanguage - Required before problem-specific hint and solution tools
request_hint
- Advances progressive hint levels for the active session
- Parameters:
titleSlug - Unlocks community solution tools after the final hint level
get_session_state
- Shows current hint level and session metadata
- Parameters:
titleSlug
reset_session
- Resets hint progress for a problem
- Parameters:
titleSlug
Local Runner Tools
runner_doctor
- Reports which local runtimes are available for supported languages
run_local_tests
- Runs user code against sample tests in a local subprocess sandbox
- Parameters:
titleSlug,language,code, optionaltimeoutMs
Solution Tools
list_problem_solutions
- Lists community/editorial solution articles for a problem
- Parameters:
questionSlug, optionallimit,skip,orderBy,userInput,tagSlugs - Requires the session to reach the solution-unlocked hint level
get_problem_solution
- Fetches a specific solution article
- Parameters:
topicId,titleSlug - Requires the session to reach the solution-unlocked hint level
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_recent_submissions
- Get submission history with filtering
get_recent_ac_submissions
- Get recent accepted submissions
get_user_status
- Get authenticated user's status/profile summary
get_problem_submission_report
- Get submission report for one problem
get_problem_progress
- Get solved/attempted progress for a problem
get_all_submissions
- Get paginated submission history
get_user_contest_ranking
- View contest performance and rankings
Learning Mode
The Interactive LeetCode MCP includes AI agent guidance through MCP Prompts to create a better learning experience.
Features
Workspace Setup: When learning mode is active, Claude will:
- Create a workspace file named
{problem-slug}.{extension} - Paste the code template into the file
- Set up proper naming conventions (e.g., Java class names)
Learning-Guided Mode: When active, Claude follows these guidelines:
- Provides progressive hints (4 levels) before revealing solutions
- Asks guiding questions about approach and complexity
- Encourages independent problem-solving
- Only shows complete solutions when explicitly requested
Problem Workflow: Guides you through the complete cycle:
- Understand the problem
- Plan the approach
- Set up workspace
- Implement with hints
- Optimize and analyze complexity
- Submit and review results
How to Use Learning Mode
To activate learning mode, tell Claude you want to practice with guidance — for example, "Let's practice in learning mode" or "I want to learn two-sum with hints." Once active:
- Call
get_startedto load the server's usage guide - Fetch a problem with
get_daily_challenge,search_problems, orget_problem - Open a session with
start_problem - Ask for hints via
request_hintrather than jumping straight to solutions - Implement your solution with progressive guidance
- Request the solution only after the final hint level or when you want to compare with an optimal approach
Dogfood Testing
To test the MCP server as a black-box MCP client without live LeetCode traffic:
This builds the server, spawns build/index.js over stdio, connects with the
MCP SDK client, uses an isolated HOME, serves LeetCode responses from fixtures,
and drives a user-like flow through runner_doctor, start_problem,
request_hint, run_local_tests, and get_session_state.
See DOGFOOD_TESTING.md for the full workflow and a copy-paste prompt for local Claude/agent dogfood testing.
Troubleshooting
"Not authorized" or "Invalid credentials" error
- Ask Claude to "Authorize with LeetCode" to start fresh authentication
- Make sure you're logged into LeetCode in your browser before extracting cookies
- Verify you copied the complete cookie values (they can be very long)
- Check that you didn't accidentally copy extra spaces or characters
"Credentials have expired"
- LeetCode cookies typically expire after 7-14 days
- Simply ask Claude to "Authorize with LeetCode" again
- You'll need to extract fresh cookies from your browser
Can't find DevTools or cookies
- Ask Claude which browser you're using - Claude will provide browser-specific instructions
- In Chrome: Press F12, click "Application" tab, expand "Cookies"
- In Firefox: Press F12, click "Storage" tab, expand "Cookies"
- In Safari: Enable Developer menu first (Preferences → Advanced), then Develop → Show Web Inspector
Copied wrong values
- Make sure you're copying the VALUE column, not the name
- The values should be long random strings (50+ characters)
- Double-click the value to select all of it before copying
- If you're unsure, Claude can guide you through the process again
Browser doesn't open during authorization
- That's okay! Just open https://leetcode.com/accounts/login/ manually
- Claude will still guide you through the cookie extraction process
"Unsupported language" error
- Supported languages: java, python, python3, cpp, c++, javascript, js, typescript, ts
Submission timeout
- LeetCode may be experiencing high traffic - wait and retry
- Check your internet connection
Skills & Plugins
This repo also ships an agent skill that teaches Claude (and other AI agents) how to use the MCP server correctly — including session flow, prompt invocations, learning mode, and authentication.
Claude Code Plugin
Install the skill directly as a Claude Code plugin:
Then start a practice session with:
ClawHub (OpenClaw / Clawbot)
The skill is also published on ClawHub for use with OpenClaw-compatible agents.
Acknowledgements
Forked from Leetcode mcp)
License
MIT © SPerekrestova