Skip to main content
Glama

✨ 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)

  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. (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
  3. Download the MCP bundle
    šŸ‘‰ 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


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
    
    # 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:

    {
      "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

get_order_history

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

Star History Chart


Available Tools

15 tools
add_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

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

    B3.4/5.0

    Scored across 15 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables Claude to browse stores, search products, manage the cart, and open checkout on Rappi Chile through natural language, automating grocery and delivery purchases.
      12
      1
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Automated 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.
      18
      1
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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