Blinkit MCP

A Model Context Protocol (MCP) server that lets Claude Desktop browse, search, and order from Blinkit in real time.

---

✨ 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

No manual clicking required. Just ask Claude to buy milk.

---

🎬 Quick Demo

💡 Ask Claude: "Buy milk from Blinkit"

---

🚀 Quick Start (30 seconds)

1. Install uv (if you don't have it):

   macOS / Linux

   curl -LsSf https://astral.sh/uv/install.sh | sh

   Windows

   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Download the MCP bundle
   👉 blinkit-mcp.mcpb

3. Double-click the .mcpb file — Claude Desktop installs it automatically.

4. 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:

1. Clone and Run:

   git clone https://github.com/hereisSwapnil/blinkit-mcp.git
   cd blinkit-mcp
   uv run playwright install
   uv run main.py

2. 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 HEADLESS to false to see the browser action, or true for background mode)

🧰 Available MCP Tools

Tool	Description
check_login	Check if currently logged in
login	Login with phone number
enter_otp	Verify login with OTP
set_location	Manually search and set delivery location
search	Search for products
add_to_cart	Add product to cart by index
remove_from_cart	Remove item from cart
check_cart	View cart contents
checkout	Proceed to checkout
get_addresses	Get list of saved addresses
select_address	Select a delivery address
proceed_to_pay	Proceed to payment page
get_upi_ids	List available UPI payment options
select_upi_id	Select a specific UPI ID for payment
pay_now	Click the final Pay Now button

---

💬 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
│   └── 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.