BrokerInbox MCP Server

by DISHANK-PATEL

139 downloads Not rated yet

About

BROKER Inbox is an MCP server integrated with Claude that allows users to buy and sell stocks on the Zerodha exchange using natural language prompts. It can also fetch and analyze emails from Gmail for insightful automation and assistance.

Explore

1. Gmail Integration
- OAuth2 authentication with google-api-python-client and google-auth-oauthlib
- Fetch inbox, search by query, read message content
- Send new emails or replies
- Delete emails or move to trash
- Analyze email content (sentiment, keyword extraction, summarization)

2. Zerodha Trading
- Kite Connect REST API client via official kiteconnect SDK
- Place market / limit orders
- Fetch holdings, positions, and order history
- Retrieve live market data (LTP, OHLC)

3. LLM Orchestration
- Expose Gmail & Zerodha actions as callable HTTP endpoints
- Claude / Cursor client connects to MCP server
- Natural language prompt routing to appropriate tool
- Integration with LangChain for complex chaining

4. Session & Persistence
- Store OAuth tokens, trade logs, email history
---

1. Clone & install
```bash
git clone https://github.com/DISHANK-PATEL/Broker-Inbox.git
cd project
npm install
bun index.ts
Get the apiKey,apiSecret,access_token
Enable Gmail API
Configure OAuth Consent Screen

BrokerInbox is a multi-agent collaboration protocol (MCP) server that integrates AI agents (e.g., Claude or Cursor) with Gmail and Zerodha's Kite Connect API. Using natural language prompts, users can:

- Read, send, delete, and analyze Gmail messages
- Place trades, fetch positions, and query market data on Zerodha
- Chain complex workflows with optional LangChain/OpenAI Functions

---

Core Features

1. Gmail Integration
- OAuth2 authentication with google-api-python-client and google-auth-oauthlib
- Fetch inbox, search by query, read message content
- Send new emails or replies
- Delete emails or move to trash
- Analyze email content (sentiment, keyword extraction, summarization)

2. Zerodha Trading
- Kite Connect REST API client via official kiteconnect SDK
- Place market / limit orders
- Fetch holdings, positions, and order history
- Retrieve live market data (LTP, OHLC)

3. LLM Orchestration
- Expose Gmail & Zerodha actions as callable HTTP endpoints
- Claude / Cursor client connects to MCP server
- Natural language prompt routing to appropriate tool
- Integration with LangChain for complex chaining

4. Session & Persistence
- Store OAuth tokens, trade logs, email history
---

Flowchart:


image

Sequene Diagram:


image

Use Case Diagram:


image image

Quick Start

1. Clone & install
```bash
git clone https://github.com/DISHANK-PATEL/Broker-Inbox.git
cd project
npm install
bun index.ts
Get the apiKey,apiSecret,access_token
Enable Gmail API
Configure OAuth Consent Screen

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.