groww-mcp

  ____  ____   ___  _ _ _ _ _ _       __  __  ____  ____
 / ___|/ ___| / _ \| | | | | | |     |  \/  |/ ___|/ _  |
| |  _| |___ | | | | | | | | | | __  | |\/| | |   | |_) |
| |_| |\___ \| |_| | |_| |_| |/ / | | |  | | |___|  __/
 \____|____/  \___/ \_____/|___/  |_| |_|  \____|_|

Trade on Groww. Through Claude.

---

What is this

An MCP server that connects Claude Desktop to Groww's trading platform. It registers 23 tools that let you manage equity holdings, place buy/sell orders, track live market data, run SIPs, and invest in mutual funds -- all through natural language prompts in Claude. Supports a full mock mode for demos without touching real money.

---

Architecture

┌──────────────────┐         stdio / MCP          ┌──────────────────────┐
│                  │ ────────────────────────────> │                      │
│  Claude Desktop  │                               │     groww-mcp        │
│  (MCP Client)    │ <──────────────────────────── │     (MCP Server)     │
│                  │      tool results (text)       │                      │
└──────────────────┘                               └──────────┬───────────┘
                                                              │
                                                              │ HTTPS
                                                              │ axios + retry
                                                              v
                                                   ┌──────────────────────┐
                                                   │     Groww API        │
                                                   │   (or mock layer)    │
                                                   └──────────────────────┘

                              ┌──────────────────────────────────────────┐
                              │            Registered Tools              │
                              ├────────────┬───────────┬─────────────────┤
                              │ portfolio  │  orders   │    market       │
                              │ positions  │  watchlist│    quotes       │
                              │ holdings   │  modify   │    OHLC         │
                              ├────────────┼───────────┼─────────────────┤
                              │    SIP     │   funds   │   search        │
                              │ create     │  invest   │   top movers    │
                              │ pause/stop │  details  │   status        │
                              └────────────┴───────────┴─────────────────┘

---

Quickstart

1. Clone and build

git clone https://github.com/darved2305/groww-mcp.git
cd groww-mcp
npm install
cp .env.example .env     # add your GROWW_API_TOKEN or leave MOCK_MODE=true
npm run build

2. Register with Claude Desktop

Open your claude_desktop_config.json and add:

{
  "mcpServers": {
    "groww": {
      "command": "node",
      "args": ["/absolute/path/to/groww-mcp/dist/index.js"],
      "env": {
        "MOCK_MODE": "true",
        "GROWW_API_TOKEN": "your_token_here"
      }
    }
  }
}

3. Restart Claude Desktop. You're done.

---

Tools

23 tools across 6 domains.

Portfolio

#	Tool	Description	Params
1	get_holdings	Current equity holdings with P&L	--
2	get_portfolio_summary	Invested, current value, day P&L	--
3	get_positions	Intraday open positions	--
4	get_order_history	Past orders, filterable by date	start_date?, end_date?

Market

#	Tool	Description	Params
5	get_quote	LTP, bid/ask, volume for symbol	symbol, exchange?
6	search_stocks	Fuzzy search stocks by name/ticker	query
7	get_ohlc_data	OHLC candles, 1d/1w/1m/1y	symbol, interval?
8	get_top_movers	Top 5 gainers and losers	--
9	get_market_status	NSE/BSE open or closed	--

Orders

#	Tool	Description	Params
10	place_order	BUY/SELL, MARKET/LIMIT, CNC/MIS	symbol, order_type, quantity, price?
11	cancel_order	Cancel a pending order	order_id
12	modify_order	Change price or quantity	order_id, price?, quantity?
13	get_order_status	Real-time order status	order_id

Watchlist

#	Tool	Description	Params
14	get_watchlist	All watchlist symbols with LTP	--
15	add_to_watchlist	Add a symbol	symbol, exchange?
16	remove_from_watchlist	Remove a symbol	symbol, exchange?

SIP

#	Tool	Description	Params
17	list_sips	All active SIPs with next date	--
18	create_sip	New SIP: fund, amount, frequency	isin, amount, frequency, start_date
19	pause_sip	Pause an active SIP	sip_id
20	cancel_sip	Cancel SIP permanently	sip_id

Mutual Funds

#	Tool	Description	Params
21	search_funds	Search by name, category, AMC	query, category?, amc?
22	get_fund_details	NAV, AUM, expense ratio, returns	isin
23	invest_in_fund	One-time lumpsum investment	isin, amount

---

Example Prompts

"What's my current portfolio P&L today?"

"Buy 10 shares of RELIANCE at market price"

"Show me top gainers on NSE right now"

"Start a 5000/month SIP in Mirae Asset Large Cap"

"Cancel all my pending orders"

---

Environment Variables

Variable	Required	Default	Description
GROWW_API_TOKEN	Yes*	--	Groww API token for authentication
GROWW_BASE_URL	No	https://api.groww.in/v1	Base URL for the Groww API
MOCK_MODE	No	false	Set to true for demo data, no real API calls
NODE_ENV	No	development	Runtime environment

*Not required when MOCK_MODE=true.

---

Mock Mode

The server ships with a full mock data layer. Set MOCK_MODE=true in your environment and every tool returns realistic hardcoded data using real Indian stocks (RELIANCE, TCS, INFY, HDFCBANK, ICICIBANK, WIPRO, BAJFINANCE) and real mutual fund schemes. No Groww account needed. No API calls made.

MOCK_MODE=true node dist/index.js

---

WARNING

This software can place real trades and move real money.

A poorly worded prompt can trigger a market order. A misunderstood confirmation can invest your savings in the wrong fund. The mock mode exists specifically so you don't learn this the hard way.

Use MOCK_MODE=true until you are absolutely certain. Test with small amounts first. The authors of this project accept zero responsibility for financial losses incurred through use of this tool.

---

License

MIT