graph TD
    User["👤 User ('Check calendar & book Leo movie')"] --> Host["🤖 AI Host (Claude Desktop)"]
    Host --> Bridge["🌉 MCP Protocol Bridge"]
    
    subgraph "Local MCP Server (bms_server.py)"
        Bridge --> Tool1["📅 check_google_calendar()"]
        Bridge --> Tool2["🔍 search_theaters()"]
        Bridge --> Tool3["⏰ check_shows()"]
        Bridge --> Tool4["🎟️ book_ticket(movie, theater, otp)"]
    end
    
    Tool1 --> GoogleCloud["☁️ Google Calendar API (Live OAuth v3)"]
    Tool4 --> Guardrail["🛡️ OTP Guardrail Engine"]
    
    GoogleCloud --> Host
    Guardrail --> Host
    Host --> Response["✅ Autonomous Recommendation & Booking"]

├── bms_server.py                    # Core MCP Server with Calendar & BMS Tools
├── mcp_config.json                  # MCP Server configuration bridge
├── credentials.template.json        # Google OAuth credentials blueprint
├── requirements.txt                 # Python dependencies
├── PROJECT_REPORT_MCP_ASSISTANT.md  # Detailed Technical & Executive Report
├── PROJECT_REPORT_MCP_ASSISTANT.html# Printable Executive HTML Report
├── .gitignore                       # Safeguards OAuth tokens & secrets
└── README.md                        # Documentation

git clone https://github.com/YOUR_USERNAME/mcp-personal-assistant.git
cd mcp-personal-assistant
pip install -r requirements.txt

{
  "mcpServers": {
    "personal-assistant": {
      "command": "python",
      "args": [
        "/absolute/path/to/mcp-personal-assistant/bms_server.py"
      ]
    }
  }
}

User: "Check my Google Calendar to see my schedule for today, and suggest movie timings for Leo in Chennai."

Claude:
- Invoked tool: check_google_calendar()
  → Fetched live events: "Leo Movie Discussion (2:00 PM - 3:00 PM)" & "Leo Movie Discussion (5:45 PM - 9:45 PM)"
- Invoked tool: search_theaters(city="Chennai", movie="Leo")
  → Venues available: PVR (Evening), INOX (Night), Sathyam (Afternoon)
- Agent Reasoning: "Given your 2:00 PM and 5:45 PM blocks, a night show at INOX fits cleanest without clashing. Shall I proceed?"

User: "Okay, book the night show at INOX for Leo."

Claude:
- Invoked tool: book_ticket(movie="Leo", theater="INOX", otp="")
  → Guardrail Response: "❌ Rule Error: OTP required for security!"
- Claude prompts user for 4-digit OTP.

User: "1234"

Claude:
- Invoked tool: book_ticket(movie="Leo", theater="INOX", otp="1234")
  → Result: "✅ Booked — Leo, night show, INOX. Enjoy the movie! 🎬"