Quick Start

Prerequisites

• Ruby >= 3.1.0 (tested on 4.0.1)
• A Groww trading account with API access

Installation

git clone https://github.com/developerjai/groww-mcp.git
cd groww-mcp
bundle install

Configuration

cp .env.example .env

Edit .env with your Groww credentials (see Authentication below).

Connect to Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "groww": {
      "type": "stdio",
      "command": "ruby",
      "args": ["/path/to/groww-mcp/bin/groww-mcp"],
      "env": {
        "GROWW_TOTP_KEY": "your_totp_key",
        "GROWW_TOTP_SECRET": "your_totp_secret"
      }
    }
  }
}

Or use with Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "groww": {
      "command": "ruby",
      "args": ["/path/to/groww-mcp/bin/groww-mcp"]
    }
  }
}

Authentication

Groww MCP supports 3 authentication methods. Choose the one that fits your workflow:

Method 1: TOTP (Recommended)

Fully automated. No daily manual steps. The server generates access tokens automatically using a TOTP secret.

Setup (one-time, 2 minutes):

1. Go to groww.in → Log in

2. Navigate to Profile → Settings → Trading APIs

3. Click "Generate API key" dropdown → "Generate TOTP token"

4. You'll get two values:

   • TOTP Token (a long JWT string starting with eyJ...) → This is your GROWW_TOTP_KEY
   • TOTP QR Secret (a short base32 string like UG3X...) → This is your GROWW_TOTP_SECRET

5. Add to your .env:

GROWW_TOTP_KEY=eyJraWQi...your_totp_jwt_key
GROWW_TOTP_SECRET=UG3XTATB22XLH5SGGLHHV736PEOYUZSB

That's it. The server will automatically generate fresh access tokens on every startup. No manual steps, no daily website visits.

Method 2: API Key + Secret (Approval)

Requires daily approval on the Groww website before the server can generate tokens.

Setup:

1. Go to groww.in → Settings → Trading APIs
2. Click "Generate API key" → Create a key
3. Copy the API Key and API Secret
4. Add to .env:

GROWW_API_KEY=eyJraWQi...your_api_key
GROWW_API_SECRET=your_api_secret

5. Daily: Visit the Trading APIs page and click "Approve" next to your key

Method 3: Direct Access Token (Manual)

For quick testing. Token expires daily at 6:00 AM IST.

1. Go to groww.in → Settings → Trading APIs
2. Click "Generate API key" dropdown → "Generate Access Token"
3. Copy the token
4. Add to .env:

GROWW_ACCESS_TOKEN=eyJraWQi...your_access_token

⚠️ You'll need to regenerate this token every day before 6:00 AM IST.

Tools

Portfolio (Free)

Orders (Free)

Smart Orders — GTT/OCO (Free)

GTT (Good Till Triggered): Automatically places an order when price hits your target. OCO (One Cancels Other): Sets both stop-loss AND target — whichever hits first executes.

Market Data (₹499/mo subscription)

Market data tools require the Groww Live Data subscription (₹499 + GST/month). Without it, these tools will return a clear error message explaining how to subscribe.

Instruments (Free)

Backtesting (₹499/mo subscription)

Other

Groww API Rate Limits

Examples

Once connected, you can use natural language with your AI assistant:

"Show me my current holdings"
"What's my available margin?"
"Place a limit buy order for 10 shares of RELIANCE at ₹2,800"
"Cancel order ORD123456"
"Get the current price of INFY" (requires Live Data subscription)

Project Structure

groww-mcp/
├── bin/
│   └── groww-mcp              # Executable entry point
├── lib/
│   ├── groww_mcp.rb           # Main module, tool registry (25 tools)
│   └── groww_mcp/
│       ├── version.rb         # Gem version
│       ├── auth.rb            # 3-method authentication (TOTP, approval, manual)
│       ├── client.rb          # Groww API client (net/http, correct endpoints)
│       ├── base_tool.rb       # Shared tool helpers
│       └── tools/
│           ├── auth_tools.rb          # authenticate
│           ├── portfolio_tools.rb     # holdings, positions, margins
│           ├── order_tools.rb         # place, modify, cancel, list, detail
│           ├── smart_order_tools.rb   # GTT, OCO (create, modify, cancel, list)
│           ├── market_tools.rb        # quote, LTP, OHLC, historical
│           ├── option_chain_tools.rb  # option chain, order trades, backtest
│           ├── instrument_tools.rb    # search, detail, CSV download
│           └── user_tools.rb          # profile
├── .env.example               # Configuration template
├── Gemfile                    # Dependencies
├── groww-mcp.gemspec          # Gem specification
├── LICENSE                    # MIT
└── README.md                  # This file

Important Notes

• Access tokens expire daily at 6:00 AM IST. TOTP auth handles this automatically.
• SEBI compliance: Groww requires a static IP for order placement. Register yours at Trading APIs → "Add static IP".
• Live Data (quotes, LTP, OHLC, historical) requires the ₹499/mo subscription.
• Order placement executes real trades with real money. The AI will always confirm before placing orders.

Other Groww MCP Servers

Looking for alternatives? Here's every Groww MCP server available:

Built for Groww

This project is built on top of the Groww Trade API to make algorithmic and AI-assisted trading accessible to every Groww user.

@AskGroww — If you're from the Groww team, I'd love to collaborate. This MCP server makes your Trade API accessible to every AI assistant (Claude, GPT, Gemini) through the open MCP standard. Let's make Groww the most AI-friendly broker in India.

Contributing

Contributions are welcome! Whether it's a bug fix, new tool, documentation improvement, or feature idea — all PRs are appreciated.

See CONTRIBUTING.md for guidelines.

Some ideas to get started:

• Add support for mutual fund tools (SIP, redemption, NAV)
• Improve error messages an