โจ 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.
๐ฌ 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 chromium -
Download the MCP bundle
๐ blinkit-mcp.mcpb -
Double-click the
.mcpbfile โ Claude Desktop installs it automatically. -
Open Claude Desktop and start shopping.
๐ฅ Key Features
๐ฆ 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.py -
Configure 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
๐ฌ 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.