# aranjan/kite-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/aranjan/kite-mcp  
**GitHub Stars:** 6  
**npm Downloads (last month):** 234  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/aranjan-kite-mcp

## Description
Trade Indian stocks on Zerodha Kite via natural conversation. 14 tools for holdings, orders, quotes, GTT triggers, and more with automated TOTP login.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "kite-mcp": {
    "command": "uvx",
    "args": ["kite-mcp"],
    "env": {
      "KITE_API_KEY": "",
      "KITE_API_SECRET": "",
      "KITE_USER_ID": "",
      "KITE_PASSWORD": "",
      "KITE_TOTP_SECRET": ""
    }
  }
}
```

**Requires environment variables:** `KITE_API_KEY`, `KITE_API_SECRET`, `KITE_USER_ID`, `KITE_PASSWORD`, `KITE_TOTP_SECRET` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What aranjan/kite-mcp MCP server does

aranjan/kite-mcp MCP server exposes Zerodha Kite account and trading operations through the Model Context Protocol. An MCP-compatible assistant can use it to retrieve holdings, intraday and delivery positions, order history, available margins, live quotes, OHLC values, historical candles, and searchable instruments across NSE, BSE, NFO, and MCX.

Trading operations include placing buy and sell orders, modifying or cancelling pending orders, viewing Good Till Triggered orders, and creating single or OCO GTT triggers. The server supports delivery (CNC), intraday (MIS), F&O (NRML), and after-market orders (AMO), according to the supplied documentation.

## How it works

The assistant interprets a natural-language request and calls the appropriate MCP tool. The server then communicates with the Zerodha Kite API. For example, an assistant can look up a company name, retrieve a quote, inspect available funds, and submit an order through separate tool calls.

Authentication can be automated with a Zerodha client ID, password, Kite Connect API credentials, and a TOTP seed. The server generates TOTP codes during login and can retry authentication when an access token becomes stale. Without the TOTP seed, a separate daily login command is required and the resulting token is cached for the day.

## Setup and configuration

Install the Python package with `pip install kite-mcp`. Configure the MCP client to launch the `kite-mcp` command and provide these environment variables:

- `KITE_API_KEY`
- `KITE_API_SECRET`
- `KITE_USER_ID`
- `KITE_PASSWORD`
- `KITE_TOTP_SECRET` (optional)

The API key and secret come from a Kite Connect API app. The user ID is the Zerodha client ID. `KITE_TOTP_SECRET` is the base32 seed from an external authenticator setup and enables automated login. If it is omitted, run `kite-mcp-login` manually each day after setting the required credentials.

## Tools and capabilities

The 14 documented tools are:

- `kite_login` for authentication with TOTP
- `get_holdings`, `get_positions`, and `get_orders` for account and trading records
- `get_margins` for available funds and margins
- `get_quote`, `get_ohlc`, and `get_historical_data` for market data
- `get_instruments` for finding tradeable instruments
- `place_order`, `modify_order`, and `cancel_order` for order management
- `get_gtt_triggers` and `place_gtt` for GTT orders, including single and OCO triggers

The tool set fits conversational portfolio reviews, quote checks, supported buy or sell requests, order cancellation, and stop-loss or target trigger setup. The assistant can work with stock names in plain English and map them to trading symbols, as described by the project.

## Limitations and notes

This server requires a Zerodha account and Kite Connect API credentials. It is intended for local execution; the documentation states that credentials are passed through environment variables, access tokens are cached at `~/.zerodha_kite_token.json`, and Zerodha communication uses HTTPS.

The TOTP secret is optional, but omitting it removes fully automated daily authentication. Access tokens expire daily, so manual-login users must repeat that process. The roadmap lists option-chain data, basket orders, mutual-fund tools, watchlist management, portfolio analytics, streaming alerts, and multiple-account support as future work rather than current capabilities.

Use aranjan/kite-mcp MCP server with a client that supports MCP, including Claude Desktop, Cursor, or Windsurf. The project is released under the MIT license.

_Full upstream README: https://allmcps.com/mcp/aranjan-kite-mcp/readme_