BrokerInbox MCP Server

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:

Sequene Diagram:

Use Case Diagram:

Quick Start

1. Clone & install

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