🎼 Meeting Maestro — The Open-Source AI Scheduling Assistant

Effortless meeting coordination. No scheduling links. No friction. Just CC and go.

---

🚀 Overview

Meeting Maestro is an open-source, email-first AI meeting assistant designed for founders, operators, and busy professionals who want assistant-level support without giving up full calendar access.

Instead of forcing users into a scheduling link or heavy CRM system, Meeting Maestro works wherever you already are:

Just CC your Maestro alias → it detects the confirmed meeting → it drafts & sends the calendar invite automatically.

This project was inspired by real-world founder frustrations seen across Reddit, Discord, and startup communities: manual invites, forgotten reminders, messy email coordination, and tools that require too much access.

Meeting Maestro brings:

• Zero-friction scheduling
• AI-driven automation
• Inbox-native workflow
• Calendar invites without lifting a finger

All while staying open, transparent, and customizable.

---

✨ Core Features

📨 1. Email-First Automation (No New Workflow Required)

• CC your Maestro email address → it detects meeting confirmation.
• Parses dates, times, participants from natural emails.
• Automatically generates and sends a clean calendar invite.
• Works with Gmail, Outlook, custom domains, and most email clients.

📅 2. Calendar Invite Generation

• Google Calendar + Outlook support
• Clean, branded meeting templates
• Auto-adds video links (optional)

⏰ 3. Smart Reminders

• Pre- and post-meeting reminders
• Optional follow-up templates
• AI-generated action items (future feature)

🧠 4. AI-Driven Parsing

• Natural language email parsing
• Multi-person scheduling detection
• Intelligent edge case handling

🔐 5. Privacy-First Design

• No full-calendar access required
• No sensitive permissions needed
• Minimal data retention with user control

🧩 6. Modular, Extensible Architecture

Easily connect Meeting Maestro to:

• n8n
• Make.com
• Zapier
• CRMs (HubSpot, GoHighLevel, Zoho, Salesforce)
• DealScale infra (if self-hosted)

🛠️ 7. Built on Modern Stack

• Next.js 14 App Router
• TypeScript
• Tailwind + shadcn/ui
• Supabase / PostgreSQL
• OpenAI-compatible inference
• n8n or Kestra automation layer

---

📦 Getting Started

Prerequisites

• Node.js 20+
• pnpm 8+
• Supabase project (recommended)
• Google Calendar API credentials

---

🔧 Installation

Clone the repo:

git clone https://github.com/your-username/meeting-maestro.git
cd meeting-maestro

Install dependencies:

pnpm install

---

🔑 Environment Variables

Create .env.local:

# Database
DATABASE_URL="postgresql://USER:PASSWORD@HOST:5432/maestro"

# Email Parsing / SMTP
SMTP_HOST=
SMTP_USER=
SMTP_PASS=

MAESTRO_ALIAS=assistant@yourdomain.com

# Google Calendar
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=

# AI (OpenAI / Anthropic / Azure OpenAI)
AI_API_KEY=

# Optional analytics
CLARITY_PROJECT_ID=
GOOGLE_ANALYTICS_ID=

---

🚀 Run Development Server

pnpm dev

Open: 👉 http://localhost:3000

---

🧱 Architecture Overview (High-Level)

Meeting Maestro is built for modularity, extensibility, and scalability.

1️⃣ Frontend

• Next.js App Router
• Tailwind + shadcn/ui
• Minimal UI (email-first workflow)

2️⃣ Backend

• Supabase / Postgres
• Edge functions for parsing
• Secure API routes for scheduling logic
• A2A-enabled automation engine

3️⃣ Automation Layer

Supports:

• n8n (recommended)
• Kestra
• Make.com
• Custom HTTP webhook triggers

Used for:

• Email parsing
• Invite generation
• Reminder workflows
• CRM sync (optional)

4️⃣ Meeting Engines

• Google Calendar API
• Outlook Graph API
• ICS creation for universal compatibility

---

📚 Documentation

Available under /docs:

• architecture.md
• api-routes.md
• email-parsing.md
• automation-examples.md
• deployment-guide.md
• privacy.md
• contributing.md

---

🧪 CI/CD

• GitHub Actions for build, lint, type-check, and tests
• Docker support
• Deploy on Vercel / Fly.io / Render

---

🌍 SEO + Open Source Use Cases

Meeting Maestro is optimized for discoverability and solves real needs validated by Reddit posts such as:

• “Why is scheduling still this painful?”
• “Why do I need to use a scheduling link for everything?”
• “Is there an AI assistant that just sends invites?”
• “I hate giving calendar access to apps.”
• “Looking for a lightweight scheduling assistant that isn’t a full CRM.”

This README targets these keywords:

• AI scheduling assistant
• AI executive assistant
• meeting automation tool
• email-based scheduling
• open-source scheduling assistant
• meeting invite automation
• founder productivity tools

---

🤝 Contributing

Contributions are welcome! Please see:

CONTRIBUTING.md
CODE_OF_CONDUCT.md

Pull requests, issues, and feature discussions are encouraged.

---

📄 License

Licensed under MIT — free for personal and commercial use.

---

⭐ Support the Project

If Meeting Maestro saves you time:

• ⭐ Star the repo
• 🍴 Fork it
• 🧩 Build plugins
• 🔌 Add integrations
• 🗣️ Share it with other founders

---

📬 Contact

For questions, ideas, or collaboration:

📧 hello@meetingmaestro.ai 🌐 https://meetingmaestro.ai (placeholder)

---

Want me to generate a Landing Page, Docs site, or GitHub Project Board for this?