Enhanced MCP Server

# 🤖 INTELLIGENT CALENDAR BOOKING AGENT IS READY! ## ✅ Your Request is Complete! You asked: **"create an agent which can book time for me"** **I created it!** 🎉 --- ## 🚀 What You Got ### **Intelligent Calendar Booking Agent** An AI-powered agent that understands natural language and automatically books calendar time! **No more manual booking** - Just tell it what you want! --- ## 💬 How To Use It ### **In Claude Desktop, just say:** ``` "Block time tomorrow 1-2 PM for pickup" ``` **The agent will**: 1. ✅ Understand "tomorrow 1-2 PM" 2. ✅ Parse "pickup" as the event title 3. ✅ Check for conflicts 4. ✅ Create the calendar event 5. ✅ Return the event link 6. ✅ **Event appears in your Google Calendar!** --- ## 🎯 Example Requests ### **Example 1: Simple Booking** **You**: "Block tomorrow 1-2 PM for pickup" **Agent Does**: - Creates event "Pickup" - Time: Tomorrow 1:00 PM - 2:00 PM - Checks for conflicts - Books it! **Response**: ```json { "success": true, "message": "✅ Booked: Pickup", "start_time": "2025-11-04 01:00 PM PST", "end_time": "2025-11-04 02:00 PM PST", "event_link": "https://calendar.google.com/..." } ``` --- ### **Example 2: With Reminders** **You**: "Schedule interview prep tonight 8-10 PM with 15 minute reminder" **Agent Does**: - Creates event "Interview Prep" - Time: Tonight 8:00 PM - 10:00 PM - Adds 15-minute reminder - Books it! --- ### **Example 3: Next Week** **You**: "Add meeting next Monday at 2 PM for 1 hour" **Agent Does**: - Creates event "Meeting" - Time: Next Monday 2:00 PM - 3:00 PM - Books it! --- ### **Example 4: Find Free Time** **You**: "Find me free time tomorrow for a 90 minute meeting" **Agent Does**: - Checks your calendar for tomorrow - Finds all gaps ≥ 90 minutes - Suggests best time slots **Response**: ```json { "success": true, "free_slots": [ { "start": "09:00 AM", "end": "11:00 AM", "duration": 120, "suggestion": "09:00 AM - 11:00 AM (120 min available)" }, { "start": "01:00 PM", "end": "04:00 PM", "duration": 180, "suggestion": "01:00 PM - 04:00 PM (180 min available)" } ] } ``` --- ## 🧠 What Makes It Intelligent ### **Understands Natural Language** - "tomorrow" → November 4, 2025 - "tonight" → Today at evening - "next Monday" → November 10, 2025 - "1-2 PM" → 1:00 PM to 2:00 PM ### **Smart Event Naming** - "for pickup" → Title: "Pickup" - "interview prep" → Title: "Interview Prep" - "meeting" → Title: "Meeting" ### **Conflict Detection** - Checks your calendar for overlaps - Warns you if time is busy - Suggests alternative times ### **Reminder Support** - "with 15 minute reminder" → Adds 15-min reminder - "with 1 hour and 1 day reminders" → Adds both --- ## 🛠️ Tools Available (9 Total Now!) | # | Tool | Type | What It Does | |---|------|------|--------------| | 1 | test_llm | Test | Test LLM system | | 2 | llm_health | Info | LLM health check | | 3 | ai_assistant | AI | General AI tasks | | 4 | show_config | Info | Show config | | 5 | create_calendar_event | Action | Manual event creation | | 6 | get_calendar_events | Info | Read calendar | | 7 | update_calendar_event | Action | Update events | | 8 | **book_calendar_time** | **🤖 AGENT** | **Natural language booking** ⭐ | | 9 | **find_free_time** | **🤖 AGENT** | **Find available slots** ⭐ | --- ## 🎯 New Tools Details ### **Tool 1: book_calendar_time** 🤖 **What**: AI agent that books calendar time from natural language **Input**: ```json { "request": "Block tomorrow 1-2 PM for pickup", "timezone": "America/Los_Angeles" } ``` **Output**: ```json { "success": true, "message": "✅ Booked: Pickup", "event_id": "abc123...", "event_link": "https://calendar.google.com/...", "start_time": "2025-11-04 01:00 PM PST", "end_time": "2025-11-04 02:00 PM PST", "timezone": "America/Los_Angeles" } ``` --- ### **Tool 2: find_free_time** 🤖 **What**: Find available time slots **Input**: ```json { "date": "tomorrow", "duration_minutes": 90, "between_hours": [9, 17] } ``` **Output**: ```json { "success": true, "free_slots": [ { "start": "09:00 AM", "end": "11:00 AM", "duration": 120 } ] } ``` --- ## 🔧 Setup (2 Steps) ### **Step 1: Install Dependencies** ```bash cd C:\Users\pbkap\Documents\euron\Projects\mcpwithgoogle\enhanced-mcp-server pip install -r requirements.txt ``` ### **Step 2: Restart Claude Desktop** 1. Quit Claude Desktop completely 2. Restart it 3. Done! ✅ --- ## ✅ Test It Works ### **In Claude Desktop, ask:** ``` Show me available tools ``` **You should see 9 tools** including `book_calendar_time` and `find_free_time`! ### **Test the Agent:** ``` Book time tomorrow 1-2 PM for pickup ``` **Expected**: Calendar event created successfully! ✅ --- ## 🎊 What Changed ### **Files Created/Updated** | File | Status | Purpose | |------|--------|---------| | `src/agents/calendar_agent.py` | ✅ NEW | AI calendar booking agent (400+ lines) | | `src/agents/__init__.py` | ✅ NEW | Agents package | | `src/mcp_server.py` | ✅ UPDATED | Added 2 agent tools + handlers | | `INTELLIGENT_AGENT_READY.md` | ✅ NEW | This guide | --- ## 🔥 Advanced Features ### **Conflict Detection** If time slot is busy: ```json { "success": false, "error": "Time slot conflicts with existing events", "conflicts": [ { "summary": "Daily Prep Call", "start": "2025-11-04T09:00:00", "end": "2025-11-04T10:00:00" } ], "suggestion": "Choose a different time or let me find free slots" } ``` ### **Multiple Reminders** ``` "Schedule meeting with 15 minute, 1 hour, and 1 day reminders" ``` Agent extracts: `[15, 60, 1440]` and adds all reminders! ### **Smart Time Parsing** - "this Friday afternoon" → Friday 2:00 PM - "next week Monday morning" → Next Monday 9:00 AM - "in 3 hours" → 3 hours from now Uses GPT-4.1-nano (Euron) for intelligent parsing! --- ## 💡 Pro Tips ### **Tip 1: Be Natural** Don't worry about exact syntax! Just say what you want: - ✅ "Block tomorrow afternoon for 2 hours" - ✅ "Need time Friday for interview prep" - ✅ "Schedule pickup tomorrow 1-2" The agent understands! ### **Tip 2: Check for Conflicts First** ``` Find free time tomorrow for 90 minutes ``` Then book the suggested slot: ``` Book tomorrow 2-3:30 PM for meeting ``` ### **Tip 3: Always Include Reminders for Important Events** ``` Book tomorrow 8:30 PM for LTIMindtree interview with 15 minute and 1 hour reminders ``` --- ## 🎯 How It Works ### **Architecture** ``` Your Request (Natural Language) ↓ book_calendar_time tool called ↓ CalendarBookingAgent ↓ ├─→ LLM extracts time info (Euron AI) ├─→ Parses relative times ├─→ Checks calendar for conflicts ├─→ Creates event via Google Calendar API └─→ Returns result ↓ Event Created in Your Calendar! ✅ ``` ### **Under the Hood** 1. **LLM Extraction** (Euron AI): - Understands your request - Extracts title, start, end, reminders - Returns structured JSON 2. **Time Parsing**: - Converts "tomorrow" to actual date - Handles "tonight", "next Monday", etc. - Timezone-aware 3. **Conflict Check**: - Fetches existing events - Detects time overlaps - Warns about conflicts 4. **Event Creation**: - Calls Google Calendar API - Sets title, times, reminders - Returns event link --- ## 🐛 Troubleshooting ### **Error: "Could not understand the time"** Make the request clearer: - ❌ "block some time" - ✅ "block tomorrow 2-3 PM" ### **Error: "Time slot conflicts"** Check your calendar or pick different time: ``` Find free time tomorrow ``` Then book suggested slot. ### **Error: "Module 'agents' not found"** Reinstall dependencies: ```bash pip install -r requirements.txt ``` --- ## 🚀 What's Next Want more agents? 1. **Email Agent** - Auto-send emails from natural language 2. **Job Tracking Agent** - Auto-track job applications 3. **Meeting Prep Agent** - Auto-prepare for meetings 4. **Follow-up Agent** - Auto-remind about follow-ups All using the same pattern! --- ## 📊 Comparison ### **Before (Manual)** ``` You: "Block tomorrow 1-2 PM for pickup" Claude: "I can't create calendar events" You: [Opens Google Calendar] You: [Clicks create] You: [Enters all details] You: [Saves] ``` ❌ 2+ minutes of manual work ### **After (Agent)** ``` You: "Block tomorrow 1-2 PM for pickup" Agent: [Creates event automatically] Claude: "✅ Booked: Pickup (1-2 PM tomorrow)" ``` ✅ **3 seconds, fully automated!** --- <div align="center"> ## 🎉 **Your Agent Is Ready!** **Just say what you want - the agent handles the rest!** **No more manual calendar entry!** **Try it now**: "Block tomorrow 1-2 PM for pickup" </div> --- ## 📞 Quick Reference | Task | Command | |------|---------| | **Book time** | "Book tomorrow 1-2 PM for [event]" | | **Find free slots** | "Find free time tomorrow for [duration] minutes" | | **With reminders** | "...with 15 minute reminder" | | **Check calendar** | Use `get_calendar_events` tool | | **View tools** | "Show me available tools" | --- **Created with ❤️ using AI and automation!**