BrokerInbox MCP Server
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.
Details
- Author
- DISHANK-PATEL
- Downloads
- 139
- Categories
- Other
Jump to
- Gmail OAuth2 authentication for secure email access
- Send, read, delete, and search Gmail messages
- Analyze email content (sentiment, keywords, summarization)
- Place market and limit orders via Zerodha Kite Connect
- Fetch holdings, positions, order history, and live market data
- Expose actions as callable HTTP endpoints for LLM orchestration
Clone the repository, install dependencies with npm install, start the server with bun index.ts, then configure your API key, API secret, and access token. Enable the Gmail API and set up OAuth2 authentication. Connect a compatible AI client (e.g., Claude or Cursor) to the running MCP server to send natural language commands.
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
```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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
