Zerodha Server

Query your Zerodha trading account via MCP (Model Context Protocol). Works with Claude Code, Claude Desktop, Cursor, and other MCP-compatible AI tools.

Tools Available

Tool	Description
get_account_funds	Available balance and margins
get_portfolio_holdings	Long-term demat holdings
get_open_positions	Intraday/F&O positions with P&L
get_todays_orders	Today's order history
get_current_pnl	Combined P&L summary
get_instrument_ltp	Last traded price of any instrument
get_instrument_ohlc	OHLC data of any instrument
get_pnl_summary	Historical P&L summary for a date range (max 3 months)
get_pnl_heatmap	Daily P&L breakdown for a date range (max 3 months)

Installation

git clone https://github.com/anish5256/zerodha-mcp.git
cd zerodha-mcp
pip install -e .

Configuration

Environment Variables

The server requires these environment variables for authentication:

Variable	Description
ZERODHA_USER_ID	Your Zerodha client ID (e.g., AB1234)
ZERODHA_PASSWORD	Your Zerodha login password
ZERODHA_TOTP_KEY	Your TOTP secret key (32-character base32 string)

Getting Your TOTP Key

Your TOTP secret key is the 32-character code you used when setting up 2FA in Google Authenticator/Authy. It looks like: ABCD1234EFGH5678IJKL9012MNOP3456

If you don't have it saved, reset 2FA in Zerodha Console to get a new one.

---

Setup by Platform

Claude Code (CLI)

Add to ~/.mcp.json:

{
  "mcpServers": {
    "zerodha": {
      "command": "python",
      "args": ["/path/to/zerodha-mcp/server.py"],
      "env": {
        "ZERODHA_USER_ID": "YOUR_USER_ID",
        "ZERODHA_PASSWORD": "YOUR_PASSWORD",
        "ZERODHA_TOTP_KEY": "YOUR_TOTP_SECRET"
      }
    }
  }
}

Then restart Claude Code.

---

Claude Desktop (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "zerodha": {
      "command": "python",
      "args": ["/path/to/zerodha-mcp/server.py"],
      "env": {
        "ZERODHA_USER_ID": "YOUR_USER_ID",
        "ZERODHA_PASSWORD": "YOUR_PASSWORD",
        "ZERODHA_TOTP_KEY": "YOUR_TOTP_SECRET"
      }
    }
  }
}

Then restart Claude Desktop.

---

Claude Desktop (Windows)

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "zerodha": {
      "command": "python",
      "args": ["C:\\path\\to\\zerodha-mcp\\server.py"],
      "env": {
        "ZERODHA_USER_ID": "YOUR_USER_ID",
        "ZERODHA_PASSWORD": "YOUR_PASSWORD",
        "ZERODHA_TOTP_KEY": "YOUR_TOTP_SECRET"
      }
    }
  }
}

Then restart Claude Desktop.

---

Cursor

Add to Cursor's MCP settings (Settings > MCP):

{
  "zerodha": {
    "command": "python",
    "args": ["/path/to/zerodha-mcp/server.py"],
    "env": {
      "ZERODHA_USER_ID": "YOUR_USER_ID",
      "ZERODHA_PASSWORD": "YOUR_PASSWORD",
      "ZERODHA_TOTP_KEY": "YOUR_TOTP_SECRET"
    }
  }
}

---

Other MCP Clients

For any MCP-compatible client, configure:

• Command: python
• Args: ["/path/to/zerodha-mcp/server.py"]
• Environment Variables:
  • ZERODHA_USER_ID = Your client ID
  • ZERODHA_PASSWORD = Your password
  • ZERODHA_TOTP_KEY = Your TOTP secret

---

Usage Examples

Once configured, ask your AI assistant:

• "What's my current portfolio value?"
• "Show me my open positions"
• "What's my P&L for today?"
• "How much funds do I have available?"
• "What's the LTP of RELIANCE?"
• "Get OHLC for NIFTY 50"
• "What was my F&O profit in 2024?"
• "Show me my daily P&L for last month"

Security Notes

• Your credentials are stored locally in your MCP config file
• Credentials are never sent to the AI model, only used server-side
• Tokens are cached locally in zerodha_enctoken.txt and zerodha_console_token.txt (gitignored)
• Each user must configure their own credentials on their own machine

License

MIT