Groww MCP Server

An MCP (Model Context Protocol) server for the Groww trading platform. This enables LLM applications to interact with your Groww trading account.

Features

• Orders: Place, modify, cancel, and list orders across Equity, F&O, and Commodities

• Portfolio: View holdings and positions

• Market Data: Get quotes, LTP, OHLC, and historical candle data

• Instruments: Search and lookup trading instruments

• Margin: Check available margin and calculate order margin requirements

• Live Feeds: Subscribe to real-time price updates via WebSocket

Installation

Using Docker (Recommended)

docker pull abhijeet45/growwmcp:latest

Using uvx

uvx --from git+https://github.com/abhijeetmohanan/growwmcp.git growmcp

Using pip

pip install git+https://github.com/abhijeetmohanan/growwmcp.git

From source

git clone https://github.com/abhijeetmohanan/growwmcp.git
cd growwmcp
pip install -e .

Configuration

Environment Variables

Set your Groww API credentials:

# Option 1: API Key + Secret (requires daily approval)
export GROWW_API_KEY=your_api_key
export GROWW_API_SECRET=your_api_secret

# Option 2: TOTP Flow (no expiry - recommended)
export GROWW_TOTP_TOKEN=your_totp_token
export GROWW_TOTP_SECRET=your_totp_secret

Get your API credentials from Groww Trade API.

MCP Configuration

Add to your .mcp.json (project-level) or MCP client config:

Using Docker:

{
  "mcpServers": {
    "groww": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "GROWW_API_KEY", "-e", "GROWW_API_SECRET", "abhijeet45/growwmcp:latest"],
      "env": {
        "GROWW_API_KEY": "${GROWW_API_KEY}",
        "GROWW_API_SECRET": "${GROWW_API_SECRET}"
      }
    }
  }
}

Using uvx:

{
  "mcpServers": {
    "groww": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/abhijeetmohanan/growwmcp.git", "growmcp"],
      "env": {
        "GROWW_API_KEY": "${GROWW_API_KEY}",
        "GROWW_API_SECRET": "${GROWW_API_SECRET}"
      }
    }
  }
}

Available Tools

Order Management

Portfolio

Market Data

Instruments

Margin

Live Feeds (WebSocket)

Usage Examples

Once configured, you can interact with your trading account:

• "What are my stock holdings?"

• "What are my pending orders?"

• "Buy 10 shares of RELIANCE at market price"

• "What's the current price of TCS?"

• "Show me the historical data for NIFTY"

• "How much margin do I have available?"

• "Search for silver ETFs"

Supported Exchanges & Segments

Rate Limits

Live feed: max 1000 concurrent subscriptions.

Important Notes

• TPIN Verification: Selling DEMAT holdings requires manual TPIN verification via Groww app/website. This cannot be automated via API.

• API Approval: If using API Key + Secret method, you need to approve access daily on Groww.

• Market Hours: Orders can only be placed during market hours (9:15 AM - 3:30 PM IST). AMO (After Market Orders) are queued for next trading day.