Project Overview

Create an intelligent calendar assistant that manages schedules, suggests optimal meeting times, and handles scheduling conflicts.

Step 1: Calendar Integration

// config.js
{
  mcp: {
    servers: [{
      name: 'calendar',
      type: 'stdio',
      command: 'npx',
      args: ['@mcp-servers/google-calendar'],
      env: {
        GOOGLE_CALENDAR_CREDENTIALS: process.env.CALENDAR_CREDS
      }
    }]
  }
}

Step 2: Calendar Commands

# Smart Calendar (AGENTS.md)

## Available Commands
- "What's on my calendar today/this week?"
- "Schedule a meeting with [person] about [topic]"
- "Find time for a 1-hour meeting next week"
- "Reschedule my 3pm meeting to tomorrow"

## Scheduling Rules
- Respect focus blocks (no meetings 10am-12pm)
- Prefer afternoon for external meetings
- Keep 15-min buffer between meetings
- Max 6 hours of meetings per day

Step 3: Daily Briefing

// Morning briefing at 8am
const today = await calendar.listEvents({
  timeMin: startOfDay,
  timeMax: endOfDay
});

const briefing = `
🗓️ Today's Schedule:
${formatEvents(today)}

⏰ Next: ${today[0].title} at ${today[0].start}
📍 Location: ${today[0].location || 'No location'}

💡 You have 2 hours of focus time available.
`;

Step 4: Smart Scheduling

// "Find time for a meeting with Alice next week"

const aliceAvailability = await calendar.getFreeBusy({
  emails: ['[email protected]'],
  timeMin: nextWeekStart,
  timeMax: nextWeekEnd
});

const myAvailability = await calendar.getFreeBusy({...});

// Find overlapping free slots
const options = findMutualSlots(
  myAvailability, 
  aliceAvailability,
  duration: 60
);

// Present options
"📅 Available times for meeting with Alice:
1. Mon 2pm - 3pm
2. Tue 10am - 11am  
3. Thu 3pm - 4pm

Which works best?"

Step 5: Conflict Resolution

// Handle scheduling conflicts

if (hasConflict(newEvent, existingEvents)) {
  const suggestions = [
    suggestReschedule(newEvent),
    suggestReschedule(conflictingEvent),
    suggestShorterMeeting(newEvent)
  ];
  
  return `⚠️ Conflict detected with "${conflict.title}"
  
Suggestions:
1. Move new meeting to ${suggestions[0].time}
2. Reschedule existing to ${suggestions[1].time}
3. Shorten to 30 minutes

Which would you prefer?`;
}

Conclusion

Your calendar assistant can now intelligently manage your schedule, find optimal meeting times, and handle conflicts automatically.