# Blinkit Mcp

> An Unofficial MCP server that lets Claude Desktop search products, manage carts, and complete Blinkit orders automatically using natural language commands.

- **Type:** MCP server
- **Install:** `agentstack add mcp-hereisswapnil-blinkit-mcp`
- **Verified:** Pending review
- **Seller:** [hereisSwapnil](https://agentstack.voostack.com/s/hereisswapnil)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [hereisSwapnil](https://github.com/hereisSwapnil)
- **Source:** https://github.com/hereisSwapnil/blinkit-mcp

## Install

```sh
agentstack add mcp-hereisswapnil-blinkit-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Unofficial 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

https://github.com/user-attachments/assets/531f09ad-648a-4ee2-9271-5993ce637093

> 💡 *Ask Claude: "Buy milk from Blinkit"*

---

## 🚀 Quick Start (30 seconds)

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

   **macOS / Linux**
   ```bash
   curl -LsSf https://astral.sh/uv/install.sh | sh
   ```
   **Windows**
   ```powershell
   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
   ```

2. **(Optional) Pre-install Browsers**  
   If you want to speed up the first run:
   ```bash
   uvx playwright install chromium
   # OR if you have Node.js:
   # npx playwright install chromium
   ```

3. **Download the MCP bundle**  
   👉 [blinkit-mcp.mcpb](https://github.com/hereisSwapnil/blinkit-mcp/releases/download/v1.0.2/blinkit-mcp.mcpb)

4. **Double-click** the `.mcpb` file — Claude Desktop installs it automatically.

5. **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**:
   ```bash
   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
   ```

2. **Configure Claude Desktop**:
   
   Add this to your `claude_desktop_config.json`:

   ```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](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](https://blinkit.com).

## Star History

[](https://www.star-history.com/#hereisSwapnil/blinkit-mcp&type=date&legend=top-left)

---

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hereisSwapnil](https://github.com/hereisSwapnil)
- **Source:** [hereisSwapnil/blinkit-mcp](https://github.com/hereisSwapnil/blinkit-mcp)
- **License:** MIT

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:** yes
- **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: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-hereisswapnil-blinkit-mcp
- Seller: https://agentstack.voostack.com/s/hereisswapnil
- 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%.