How nishit-luhadia30/mcp works
This repository combines a conversational LangGraph assistant with independent Gmail and Google Calendar MCP servers. The user enters a request through the agent, which discovers server tools and binds them to its model; the relevant server dispatches a tool to its service client, which performs the Google API operation. The graph preserves the distinct mail and calendar capabilities and their parsing/authentication layers. Relationships for sampled code are cited; README-supported integrations are cited to the README, and unsampled tool internals are not expanded beyond documented capabilities.
Main entry points: gcalendar/client.py Calendar Client · server.py Calendar MCP Server · gmail/client.py Gmail Client · nodes.py Tool Discovery
Components 27
Conversational Agent
- Conversation CLI
Main-Agent/main.py - Agent Graph
Main-Agent/graph.py - Tool Discovery
Main-Agent/nodes.py
Gmail MCP
- Gmail MCP Server
Gmail-MCP/server.py - Read Mail
Gmail-MCP/tools/read.py - Search Mail
Gmail-MCP/tools/search.py - Message Actions
Gmail-MCP/tools
Gmail Integration
- Gmail Client
Gmail-MCP/gmail/client.py - Message Parser
Gmail-MCP/gmail/parser.py - Gmail Service
Gmail-MCP/gmail/service.py - Gmail Auth
Gmail-MCP/gmail/auth.py
Calendar MCP
- Calendar MCP Server
Calendar-MCP/server.py - Event Reading
Calendar-MCP/tools/read.py - Event Lookup
Calendar-MCP/tools/event.py - Event Search
Calendar-MCP/tools/search.py - Event Creation
Calendar-MCP/tools/create.py - Event Updates
Calendar-MCP/tools/update.py - Event Deletion
Calendar-MCP/tools/delete.py - Availability Check
Calendar-MCP/tools/availability.py
Calendar Integration
- Calendar Client
Calendar-MCP/gcalendar/client.py - Event Parser
Calendar-MCP/gcalendar/parser.py - Calendar Service
Calendar-MCP/gcalendar/service.py - Calendar Auth
Calendar-MCP/gcalendar/auth.py
Other components
- User
- Groq Model
- Gmail API
- Calendar API
Connections 34
- User → Conversation CLI: enters request
README.md - Conversation CLI → Agent Graph: invokes graph
Main-Agent/main.py - Agent Graph → Tool Discovery: builds with
Main-Agent/graph.py - Tool Discovery → Groq Model: binds tools
Main-Agent/nodes.py - Tool Discovery → Gmail MCP Server: connects tools
Main-Agent/nodes.py - Tool Discovery → Calendar MCP Server: connects tools
Main-Agent/nodes.py - Gmail MCP Server → Read Mail: dispatches reads
Gmail-MCP/server.py - Gmail MCP Server → Search Mail: dispatches search
Gmail-MCP/server.py - Gmail MCP Server → Message Actions: dispatches actions
Gmail-MCP/server.py - Read Mail → Gmail Client: calls client
Gmail-MCP/tools/read.py - Search Mail → Gmail Client: calls client
Gmail-MCP/tools/search.py - Message Actions → Gmail Client: uses client
Gmail-MCP/tools/search.py - Gmail Client → Message Parser: parses messages
Gmail-MCP/gmail/client.py - Gmail Client → Gmail Service: gets service
Gmail-MCP/gmail/client.py - Gmail Service → Gmail Auth: gets credentials
Gmail-MCP/gmail/service.py - Gmail Client → Gmail API: calls API
Gmail-MCP/gmail/client.py - Calendar MCP Server → Event Reading: dispatches reads
Calendar-MCP/server.py - Calendar MCP Server → Event Lookup: dispatches lookup
Calendar-MCP/server.py - Calendar MCP Server → Event Search: dispatches search
Calendar-MCP/server.py - Calendar MCP Server → Event Creation: dispatches creation
Calendar-MCP/server.py - Calendar MCP Server → Event Updates: dispatches updates
Calendar-MCP/server.py - Calendar MCP Server → Event Deletion: dispatches deletion
Calendar-MCP/server.py - Calendar MCP Server → Availability Check: dispatches check
Calendar-MCP/server.py - Event Reading → Calendar Client: uses client
Calendar-MCP/tools/read.py - Event Lookup → Calendar Client: uses client
Calendar-MCP/tools/event.py - Event Search → Calendar Client: uses client
Calendar-MCP/tools/search.py - Event Creation → Calendar Client: uses client
Calendar-MCP/tools/create.py - Event Updates → Calendar Client: calls client
Calendar-MCP/tools/update.py - Event Deletion → Calendar Client: uses client
Calendar-MCP/tools/delete.py - Availability Check → Calendar Client: uses client
Calendar-MCP/tools/availability.py - Calendar Client → Event Parser: parses events
Calendar-MCP/gcalendar/client.py - Calendar Client → Calendar Service: gets service
Calendar-MCP/gcalendar/client.py - Calendar Service → Calendar Auth: gets credentials
Calendar-MCP/gcalendar/service.py - Calendar Client → Calendar API: calls API
Calendar-MCP/gcalendar/client.py