# Leetcode Mcp Server > An MCP server enabling automated access to LeetCode's problems, solutions, and public data with optional authentication for user-specific features, supporting leetcode.com & leetcode.cn sites. - **Type:** MCP server - **Install:** `agentstack add mcp-jinzcdev-leetcode-mcp-server` - **Verified:** Yes β€” security-reviewed for prompt injection and unsafe behavior - **Seller:** [jinzcdev](https://agentstack.voostack.com/s/jinzcdev) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [jinzcdev](https://github.com/jinzcdev) - **Source:** https://github.com/jinzcdev/leetcode-mcp-server - **Website:** https://www.npmjs.com/package/@jinzcdev/leetcode-mcp-server ## Install ```sh agentstack add mcp-jinzcdev-leetcode-mcp-server ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # LeetCode MCP Server [](https://www.npmjs.com/package/@jinzcdev/leetcode-mcp-server) [](https://www.npmjs.com/package/@jinzcdev/leetcode-mcp-server) [](./LICENSE) [](README_zh-CN.md) [](https://github.com/jinzcdev/leetcode-mcp-server) The LeetCode MCP Server is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) 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**: Support​ both leetcode.com (Global) and leetcode.cn (China) platforms - πŸ“Š **Problem Data Retrieval**: Obtain detailed problem descriptions, constraints, examples, official editorials, and ​user-submitted solutions - πŸ‘€ **User Data Access**: Retrieve user profiles, submission history, and contest performance - πŸ”’ **​Private Data Access**: Create and query user notes, track problem-solving progress, and analyze submission details (AC/WA analysis) - πŸ” **Advanced Search Capabilities**: Filter problems by tags, difficulty levels, categories, and keywords - πŸ“… **Daily Challenge Access**: Easily access daily challenge problems ## Prerequisites 1. Node.js (v20.x or above) 2. (Optional) LeetCode session cookie for authenticated API access ## Installation ### Installing via Smithery To install leetcode-mcp-server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@jinzcdev/leetcode-mcp-server): ```bash npx -y @smithery/cli install @jinzcdev/leetcode-mcp-server --client claude ``` ### Manual Installation ```bash # 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 ``` Alternatively, you can clone the repository and run it locally: ```bash # Clone the repository git clone https://github.com/jinzcdev/leetcode-mcp-server.git # Navigate to the project directory cd leetcode-mcp-server # Build the project npm install && npm run build # Run the server node build/index.js --site global ``` ## Usage ### Visual Studio Code Integration Add the following JSON configuration to your User Settings (JSON) file. Access this by pressing `Ctrl/Cmd + Shift + P` and searching for `Preferences: Open User Settings (JSON)`. #### Option 1: Using Environment Variables ```json { "mcp": { "servers": { "leetcode": { "type": "stdio", "command": "npx", "args": ["-y", "@jinzcdev/leetcode-mcp-server"], "env": { "LEETCODE_SITE": "global", "LEETCODE_SESSION": "" } } } } } ``` #### Option 2: Using Command Line Arguments ```json { "mcp": { "servers": { "leetcode": { "type": "stdio", "command": "npx", "args": [ "-y", "@jinzcdev/leetcode-mcp-server", "--site", "global", "--session", "" ] } } } } ``` For LeetCode China site, modify the `--site` parameter to `cn`. > [!TIP] > > The server supports the following optional environment variables: > > - `LEETCODE_SITE`: LeetCode API endpoint ('global' or 'cn', default: 'global') > - `LEETCODE_SESSION`: LeetCode session cookie for authenticated API access (default: empty) > > **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. ## Available Tools ### Problems | Tool | Global | CN | Auth Required | Description | | ----------------------- | :----: | :-: | :-----------: | ------------------------------------------------------------ | | **get_daily_challenge** | βœ… | βœ… | ❌ | Retrieves today's LeetCode Daily Challenge problem | | **get_problem** | βœ… | βœ… | ❌ | Retrieves details for a specific LeetCode problem | | **search_problems** | βœ… | βœ… | ❌ | Searches for LeetCode problems with multiple filter criteria | ### Users | Tool | Global | CN | Auth Required | Description | | --------------------------------- | :----: | :-: | :-----------: | ------------------------------------------------------------ | | **get_user_profile** | βœ… | βœ… | ❌ | Retrieves profile information for a LeetCode user | | **get_user_contest_ranking** | βœ… | βœ… | ❌ | Obtains contest ranking statistics for a user | | **get_recent_ac_submissions** | βœ… | βœ… | ❌ | Retrieves a user's recent accepted submissions | | **get_recent_submissions** | βœ… | ❌ | ❌ | Retrieves a user's recent submissions history | | **get_user_status** | βœ… | βœ… | βœ… | Retrieves current user's current status | | **get_problem_submission_report** | βœ… | βœ… | βœ… | Provides detailed submission analysis for a specific problem | | **get_problem_progress** | βœ… | βœ… | βœ… | Retrieves current user's problem-solving progress | | **get_all_submissions** | βœ… | βœ… | βœ… | Retrieves current user's submission history | ### Submissions | Tool | Global | CN | Auth Required | Description | | ------------------- | :----: | :-: | :-----------: | ------------------------------------------------------------- | | **run_code** | βœ… | βœ… | βœ… | Runs code for a problem and polls `/check/` until finished | | **submit_solution** | βœ… | βœ… | βœ… | Submits code for a problem and polls `/check/` until finished | ### Notes | Tool | Global | CN | Auth Required | Description | | ---------------- | :----: | :-: | :-----------: | ----------------------------------------------------- | | **search_notes** | ❌ | βœ… | βœ… | Searches for user notes with filtering options | | **get_note** | ❌ | βœ… | βœ… | Retrieves notes for a specific problem by question ID | | **create_note** | ❌ | βœ… | βœ… | Creates a new note for a specific problem | | **update_note** | ❌ | βœ… | βœ… | Updates an existing note with new content | ### Solutions | Tool | Global | CN | Auth Required | Description | | -------------------------- | :----: | :-: | :-----------: | -------------------------------------------------------------- | | **list_problem_solutions** | βœ… | βœ… | ❌ | Retrieves a list of community solutions for a specific problem | | **get_problem_solution** | βœ… | βœ… | ❌ | Retrieves the complete content of a specific solution | ## Tool Parameters ### Problems - **get_daily_challenge** - Retrieves today's LeetCode Daily Challenge problem with complete details - No parameters required - **get_problem** - Retrieves details about a specific LeetCode problem - `titleSlug`: The URL slug/identifier of the problem (string, required) - **search_problems** - Searches for LeetCode problems based on multiple filter criteria - `category`: Problem category filter (string, optional, default: "all-code-essentials") - `tags`: List of topic tags to filter problems by (string[], optional) - `difficulty`: Problem difficulty level filter (enum: "EASY", "MEDIUM", "HARD", optional) - `searchKeywords`: Keywords to search in problem titles and descriptions (string, optional) - `limit`: Maximum number of problems to return (number, optional, default: 10) - `offset`: Number of problems to skip (number, optional) ### Users - **get_user_profile** - Retrieves profile information about a LeetCode user - `username`: LeetCode username (string, required) - **get_user_contest_ranking** - Retrieves a user's contest ranking information - `username`: LeetCode username (string, required) - `attended`: Whether to include only the contests the user has participated in (boolean, optional, default: true) - **get_recent_submissions** - Retrieves a user's recent submissions on LeetCode Global - `username`: LeetCode username (string, required) - `limit`: Maximum number of submissions to return (number, optional, default: 10) - **get_recent_ac_submissions** - Retrieves a user's recent accepted submissions - `username`: LeetCode username (string, required) - `limit`: Maximum number of submissions to return (number, optional, default: 10) - **get_user_status** - Retrieves the current user's status - No parameters required - **get_problem_submission_report** - Retrieves detailed information about a specific submission - `id`: The numerical submission ID (number, required) - **get_problem_progress** - Retrieves the current user's problem-solving progress - `offset`: Number of questions to skip (number, optional, default: 0) - `limit`: Maximum number of questions to return (number, optional, default: 100) - `questionStatus`: Filter by question status (enum: "ATTEMPTED", "SOLVED", optional) - `difficulty`: Filter by difficulty levels (string[], optional) - **get_all_submissions** - Retrieves paginated list of user's submissions - `limit`: Maximum number of submissions to return (number, default: 20) - `offset`: Number of submissions to skip (number, default: 0) - `questionSlug`: Optional problem identifier (string, optional) - `lang`: Programming language filter (string, optional, CN only) - `status`: Submission status filter (enum: "AC", "WA", optional, CN only) - `lastKey`: Pagination token for retrieving next page (string, optional, CN only) ### Submissions - **run_code** - Runs code for a specific problem and waits until finished (requires authentication) - `titleSlug`: The URL slug/identifier of the problem (string, required) - `lang`: Programming language (string enum, required) - `typedCode`: Source code to run (string, required) - `dataInput`: Custom input to run (string, optional) - `timeoutMs`: Polling timeout in milliseconds (number, optional, default: 120000) - `pollIntervalMs`: Polling interval in milliseconds (number, optional, default: 1500) - **submit_solution** - Submits code for a specific problem and waits until finished (requires authentication) - `titleSlug`: The URL slug/identifier of the problem (string, required) - `lang`: Programming language (string enum, required) - `typedCode`: Source code to submit (string, required) - `timeoutMs`: Polling timeout in milliseconds (number, optional, default: 120000) - `pollIntervalMs`: Polling interval in milliseconds (number, optional, default: 1500) ### Notes - **search_notes** - Searches for user notes on LeetCode China - `keyword`: Search term to filter notes (string, optional) - `limit`: Maximum number of notes to return (number, optional, default: 10) - `skip`: Number of notes to skip (number, optional, default: 0) - `orderBy`: Sort order for returned notes (enum: "ASCENDING", "DESCENDING", optional, default: "DESCENDING") - **get_note** - Retrieves user notes for a specific LeetCode problem - `questionId`: The question ID of the LeetCode problem (string, required) - `limit`: Maximum number of notes to return (number, optional, default: 10) - `skip`: Number of notes to skip (number, optional, default: 0) - **create_note** - Creates a new note for a specific LeetCode problem - `questionId`: The question ID of the LeetCode problem (string, required) - `content`: The content of the note, supports markdown format (string, required) - `summary`: An optional short summary or title for the note (string, optional) - **update_note** - Updates an existing note with new content or summary - `noteId`: The ID of the note to update (string, required) - `content`: The new content for the note, supports markdown format (string, required) - `summary`: An optional new short summary or title for the note (string, optional) ### Solutions - **list_problem_solutions** - Retrieves a list of community solutions for a specific problem - `questionSlug`: The URL slug/identifier of the problem (string, required) - `limit`: Maximum number of solutions to return (number, optional, default: 10) - `skip`: Number of solutions to skip (number, optional) - `userInput`: Search term to filter solutions (string, optional) - `tagSlugs`: Array of tag identifiers to filter solutions (string[], optional, default: []) - `orderBy`: Sorting criteria for the returned solutions - Global: enum: "HOT", "MOST_RECENT", "MOST_VOTES", optional, default: "HOT" - CN: enum: "DEFAULT", "MOST_UPVOTE", "HOT", "NEWEST_TO_OLDEST", "OLDEST_TO_NEWEST", optional, default: "DEFAULT" - **get_problem_solution** - Retrieves the complete content of a specific solution - `topicId`: Unique topic ID of the solution (string, required, Global only) - `slug`: Unique slug/identifier of the solution (string, required, CN only) ## Available Resources | Resource Name | Global | CN | Auth Required | Description | | ---------------------- | :----: | :-: | :-----------: | ------------------------------------------------------------ | | **problem-categories** | βœ… | βœ… | ❌ | A list of all problem classification categories | | **problem-tags** | βœ… | βœ… | ❌ | A detailed collection of algorithmic and data structure tags | | **problem-langs** | βœ… | βœ… | ❌ | A complete list of all supported programming languages | | **problem-detail** | βœ… | βœ… | ❌ | Provides details about a specific problem | | **problem-solution** | βœ… | βœ… | ❌ | Provides the complete content of a specific solution | ## Resource URIs - **problem-categories** - A list of all problem classification categories - URI: `categories://problems/all` - **problem-tags** - A detailed collection of algorithmic and data structure tags - URI: `tags://problems/all` - **problem-langs** - A complete list of all programming languages supported by LeetCode - URI: `langs://problems/all` - **problem-detail** - Provides details about a specific LeetCode problem - URI: `problem://{titleSlug}` - Parameters: - `titleSlug`: Problem identifier as it appears in the LeetCode URL - **problem-solution** - Provides the complete content of a specific solution - Global URI: `solution://{topicId}` - Parameters: - `topicId`: Unique topic ID of the solution - CN URI: `solution://{slug}` - Parameters: - `slug`: Unique slug/identifier of the solution ## Authentication User-specific data access requires LeetCode session authentication: 1. Log in to LeetCode ([Global](https://leetcode.com) or [China](https://leetcode.cn) 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: ```json { "content": [ { "type": "text", "text": "JSON_DATA_STRING" } ] } ``` The `JSON_DATA_STRING` contains either the requested data or an error message for failed requests. ## License T … ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source β€” we do not rehost the code. - **Author:** [jinzcdev](https://github.com/jinzcdev) - **Source:** [jinzcdev/leetcode-mcp-server](https://github.com/jinzcdev/leetcode-mcp-server) - **License:** MIT - **Homepage:** https://www.npmjs.com/package/@jinzcdev/leetcode-mcp-server Install and usage instructions live in the source repository linked above. ## Pricing - **Free** β€” Free ## Security capabilities Automated source analysis of v0.1.0 β€” what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source β€” more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** β€” security scan: passed β€” Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-jinzcdev-leetcode-mcp-server - Seller: https://agentstack.voostack.com/s/jinzcdev - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack β€” the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.