home / mcp / groww mcp server

Groww MCP Server

MCP server for Groww Trading API enabling portfolio, orders, and market data actions via AI assistants.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "karthik1729-groww-mcp": {
      "command": "groww-mcp",
      "args": [],
      "env": {
        "GROWW_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

This Groww MCP Server enables AI assistants to interact with Groww Trading API by managing portfolios, placing orders, and retrieving market data. It provides a programmable interface that your AI can use to perform actions and fetch real‑time information securely through a token you supply.

How to use

You use this MCP server by connecting an MCP client to the Groww MCP Server configuration. The client can request portfolio data, quotes, orders, and margins, and it can command buy or sell actions through natural language prompts. You must provide a valid Groww API access token and configure the local MCP host channel so the client can spawn or contact the server.

Typical usage patterns include checking your portfolio, requesting real‑time prices, placing buy or sell orders, and querying available margin. Your AI assistant will translate user intents into tool calls such as get_holdings, get_quote, place_order, or get_margins, and the MCP server will execute those requests against Groww.

How to install

Prerequisites: ensure you have Go installed if you choose the Go installation path, and ensure you can download executables if you prefer the binary route.

# Option 1: Install with Go
go install github.com/karthik1729/groww-mcp/cmd/server@latest

# Binary is installed as 'server', rename for clarity
mv $(go env GOPATH)/bin/server $(go env GOPATH)/bin/groww-mcp

# Option 2: Download Binary
# Download from GitHub Releases (manual step to fetch the appropriate binary)

Additional setup and configuration

You must obtain a Groww API access token and configure your environment before starting the MCP server.

1) Get Groww API Token Generate your API access token. Note: the token expires daily at 6:00 AM IST.

2) Set Environment Variable ``export GROWW_ACCESS_TOKEN="your_token_here"``

3) Configure Claude Desktop
Add the MCP server configuration to the Claude desktop config at the following path (macOS):
```
~/Library/Application Support/Claude/claude_desktop_config.json
```
Payload example to paste into the config under mcpServers:
```
{
  "mcpServers": {
    "groww-mcp": {
      "command": "groww-mcp",
      "env": {
        "GROWW_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}
```
Windows path: `%APPDATA%\Claude\claude_desktop_config.json` and Linux path: `~/.config/Claude/claude_desktop_config.json

4) Restart Claude Desktop after saving the config so the new MCP server is loaded.

Available tools

get_holdings

Fetch the current portfolio holdings and positions for your Groww account.

get_positions

Retrieve open positions and exposure across your investments.

get_quote

Request the latest market quote for a specific instrument, such as a stock ticker.

get_ltp

Get the last traded price for a selected instrument.

get_ohlc

Obtain OHLC (open, high, low, close) data for charting timeframes.

get_historical_data

Pull historical price data for analysis over a period.

place_order

Submit a buy or sell order with quantity and instrument details.

modify_order

Amend an existing order's details such as quantity or price.

cancel_order

Cancel a pending order by its identifier.

get_orders

List current and past orders with status and details.

get_margins

Check available margin and buying power for your account.

calculate_margin

Estimate required margin for a proposed trade or position.