ai-powered-meeting-scheduler

The AI-Powered Meeting Scheduler is an AI scheduling agent that converts natural-language meeting requests into Google Calendar events. It detects scheduling conflicts, analyzes calendar patterns, and recommends personalized alternative time slots using LangChain and Gemini. It acts as an autonomous executive scheduling assistant, bridging natural language understanding and live external calendar systems.

The system automatically parses dates and times, enforces past-date guards, performs mathematical interval conflict detection, inspects historical meeting habits over the past 30 days, and recommends tailored alternative slots when conflicts occur. Key features include natural language event scheduling, strict past-date validation, mathematical overlap detection using half-open interval logic, a multi-step agent reasoning loop, working-hours free slot detection, 30-day booking pattern analytics, and deterministic calendar intelligence queries.

Technically, it is built with Python 3.10+, LangChain Core for agent orchestration, Google Gemini for LLM reasoning, and Google Calendar API v3 for live event creation and queries. It uses Google Auth & OAuth 2.0 for secure authorization. The project includes an offline unit test suite using Pytest and Unittest. Security measures include zero committed secrets, local credential storage, minimal API scopes, and input sanitization.