blinkit-mcp
Automate Blinkit grocery shopping from Claude Desktop.
Log in securely with phone/OTP and check session status.
Search products, add/remove items, and view cart.
Set/detect delivery location and choose saved addresses.
Checkout, select payment method (UPI/COD), and pay.
Retrieve order history for recurring purchases.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@blinkit-mcp Buy milk from Blinkit"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
⨠What is Blinkit MCP?
Blinkit MCP is a plug-and-play MCP server that allows Claude Desktop to automate your grocery shopping on Blinkit.
Your AI can:
š Search for products (groceries, electronics, etc.)
š Add items to your cart
š Manage delivery locations
š³ Automate checkout and UPI payments
š Login securely with phone and OTP
š Review past orders and recurring buying patterns
No manual clicking required. Just ask Claude to buy milk.
Related MCP server: Raley
š¬ Quick Demo
https://github.com/user-attachments/assets/531f09ad-648a-4ee2-9271-5993ce637093
š” Ask Claude: "Buy milk from Blinkit"
š Quick Start (30 seconds)
Install
uv(if you don't have it):macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | shWindows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"(Optional) Pre-install Browsers
If you want to speed up the first run:uvx playwright install chromium # OR if you have Node.js: # npx playwright install chromiumDownload the MCP bundle
š blinkit-mcp.mcpbDouble-click the
.mcpbfile ā Claude Desktop installs it automatically.Open Claude Desktop and start shopping.
š„ Key Features
Feature | Description |
š Secure Auth | Login via Phone Number & OTP (Session persisted locally) |
š Smart Search | Find products by name and get pricing/details |
š Cart Management | Add items, check cart status, and verify availability |
š Location | Detect or manually set delivery location |
š³ Payment Automation | New! Select saved UPI IDs or enter new ones automatically |
š Checkout Flow | Handles address selection and ordering flow seamlessly |
š¦ One-Click Installation (Recommended)
Download and install directly in Claude Desktop:
Supports: macOS ⢠Windows ⢠Linux
š ļø Manual Installation
If you prefer to run from source:
Clone and Run:
git clone https://github.com/hereisSwapnil/blinkit-mcp.git cd blinkit-mcp # Install uv (if needed) curl -LsSf https://astral.sh/uv/install.sh | sh # Install Python dependencies uv sync # Install Playwright browsers uv run playwright install chromium # Run the server uv run main.pyConfigure Claude Desktop:
Add this to your
claude_desktop_config.json:{ "mcpServers": { "blinkit-mcp": { "command": "/usr/local/bin/uv", "args": ["run", "main.py"], "cwd": "/absolute/path/to/blinkit-mcp", "env": { "HEADLESS": "false" } } } }(Set
HEADLESStofalseto see the browser action, ortruefor background mode)
š§° Available MCP Tools
Tool | Description |
| Check if currently logged in |
| Login with phone number |
| Verify login with OTP |
| Manually search and set delivery location |
| Search for products |
| Add product to cart by index |
| Remove item from cart |
| View cart contents |
| Proceed to checkout |
| Get list of saved addresses |
| Select a delivery address |
| Proceed to payment page |
| List available UPI payment options |
| Select a specific UPI ID for payment |
| Click the final Pay Now button |
| Fetch recent orders (date, total, status, and items) in an LLM-friendly format |
š¬ Example Queries
"Buy milk from Blinkit to my home and use my UPI for payment"
"Order 2 packets of Maggi and pay via UPI"
"Get me some chips, deliver to office, and checkout"
š Project Structure
blinkit-mcp/
āāā main.py # MCP server entry point
āāā src/
ā āāā auth/ # Authentication module
ā ā āāā service.py # Auth service implementation
ā āāā order/ # Order management module
ā ā āāā blinkit_order.py # Main order controller
ā ā āāā services/ # Domain services
ā ā āāā base.py # Base service class
ā ā āāā search.py # Search logic
ā ā āāā location.py # Location logic
ā ā āāā cart.py # Cart logic
ā ā āāā checkout.py # Checkout & Payment logic
ā ā āāā history.py # Order history logic
ā āāā server.py # MCP Tool definitions
āāā test/
ā āāā cli.py # CLI for testing independent of Claude
āāā README.mdš License
Licensed under the MIT License.
Blinkit MCP turns Claude into your personal grocery assistant.
ā ļø Disclaimer
This project is an experimental proof of concept and is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Blinkit (Grofers India Private Limited), or any of its subsidiaries or its affiliates. The official Blinkit website can be found at blinkit.com.
Star History
Available Tools
15 toolsadd_to_cartB
Add an item to the cart. Optional: specify quantity (default 1).
Inputs: item_id (required), quantity. Returns: result
check_cartA
Check the current cart products, total value, and the delivery address. If the delivery address is not the intended one, use get_addresses and select_address to change it.
Inputs: no named parameters. Returns: result
check_loginA
Check if the current session is logged in. Returns 'Logged In' or 'Not Logged In'.
Inputs: no named parameters. Returns: result
checkoutA
Proceed to checkout (clicks Proceed / Pay button). DO NOT call this if you need to change the delivery address. To change address, use get_addresses and select_address BEFORE checkout! Do not use set_location to fix address here.
Inputs: no named parameters. Returns: result
enter_otpC
Enter the OTP received on your phone to complete authentication.
Inputs: otp (required). Returns: result
get_addressesA
Get the list of saved addresses. Use this and select_address to change address on the cart page, if the address in check_cart is incorrect.
Inputs: no named parameters. Returns: result
get_order_historyA
Fetch recent Blinkit order history in an LLM-friendly format: for each
order, its date, total, status, and the items bought (name, variant,
quantity, price). Use this to see what the user has ordered before and infer
recurring purchases when building an order. count sets how many recent
orders to fetch (default 10).
Inputs: count. Returns: result
loginA
Log in to Blinkit. Returns status or prompts for OTP (which will be sent to your phone).
Inputs: phone_number (required). Returns: result
pay_nowB
Click the 'Pay Now' button to complete the transaction.
Inputs: no named parameters. Returns: result
proceed_to_payA
Proceed to payment (clicks Proceed button again). Use after selecting address.
Inputs: no named parameters. Returns: result
remove_from_cartC
Remove a specific quantity of an item from the cart.
Inputs: item_id (required), quantity. Returns: result
searchB
Search for a product on Blinkit. Returns a list of items with their IDs.
Inputs: query (required). Returns: result
select_addressB
Select a delivery address by its index. Only use this BEFORE checkout.
Inputs: index (required). Returns: result
select_payment_methodA
Select a payment method. Automatically chooses Cash on Delivery if available. If not, it opens UPI and generates a QR code to be scanned by the customer.
Inputs: no named parameters.
set_locationA
Manually set the delivery location via search. Pass 'detect' to click 'Detect my location'. The flow should be: login -> set_location('detect') -> add items -> check_cart -> if address not same, use get_addresses and select_address. Do not use this tool to fix address after adding items.
Inputs: location_name (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 15 tools
Several tools overlap around the checkout/payment flow (checkout, proceed_to_pay, select_payment_method, pay_now all 'click the proceed/pay button'), and address handling is split across set_location, get_addresses, and select_address. The descriptions repeatedly warn 'do not use X here, use Y instead,' which signals real ambiguity an agent could misstep on, though the warnings do mitigate it.
All names use snake_case and mostly follow a verb_noun or verb_verb pattern (get_order_history, add_to_cart, select_address). A few single-word/verb-only names (login, search, checkout) deviate slightly but remain readable and predictable.
15 tools is reasonable for a full e-commerce ordering lifecycle (auth, search, cart, address, checkout, payment). The multi-step checkout/payment segment is somewhat heavy with four separate tools, but each maps to a distinct UI action.
The surface covers the core ordering lifecycle: login/OTP, search, add/remove cart, address selection, checkout, and payment. Minor gaps like order tracking or quantity-update beyond add/remove exist, but the essential flow is complete.
Maintenance
Related MCP Connectors
Search live store shelves, verify delivery windows, and run instant AI agent checkouts.
Create instxnt.xyz storefronts through Claude: add products, connect Stripe, go live.
Connect Meta Muse and Claude agents to live local retail store shelves and direct checkout.
Run your ecommerce ads from Claude & ChatGPT: Meta, Google, Amazon, Shopify (150 tools)
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables Claude to browse stores, search products, manage the cart, and open checkout on Rappi Chile through natural language, automating grocery and delivery purchases.121MIT
- AlicenseCqualityDmaintenanceAutomated grocery shopping assistant with intelligent unit pricing and automatic coupon clipping, enabling AI to search products, manage carts, and plan grocery runs via Claude Desktop or CLI.181-
- AlicenseNot gradedqualityCmaintenanceEnables assistants to search products, build and validate a Blinkit cart, manage delivery locations and addresses, and use saved staples or combos through Blinkit's JSON API while leaving payment to the user.MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude to interact with Zepto's live quick-commerce platform through natural language, exposing tools to browse order history, resolve saved addresses, search store inventory, update the cart, retrieve payment methods, and place two-phase confirmed orders with autonomous recovery from store-routing errors.MIT