# Daily Briefing MCP Server
An MCP (Model Context Protocol) server that aggregates calendar events, meeting summaries, action items, and travel information from multiple sources into personalized daily briefings.
## Features
- **Multi-Source Aggregation**: Combines data from Google Calendar, TripIt, Fireflies.ai, and other iCal feeds
- **Daily Briefings**: Generate comprehensive daily summaries with schedule, conflicts, and action items
- **Conflict Detection**: Automatically detects overlapping events and back-to-back meetings
- **Focus Time**: Identifies available time slots for deep work
- **Meeting Summaries**: Includes AI-generated summaries from Fireflies.ai meetings
- **Travel Alerts**: Highlights upcoming travel and related alerts
- **Multiple Output Formats**: Markdown, plain text, or JSON
## Quick Start
### 1. Configure Data Sources
```bash
# Google Calendar (iCal feed)
export BRIEFING_GOOGLE_CALENDAR_URL="https://calendar.google.com/calendar/ical/..."
# TripIt (iCal feed)
export BRIEFING_TRIPIT_ICAL_URL="https://www.tripit.com/feed/ical/private/..."
# Fireflies.ai (optional)
export BRIEFING_FIREFLIES_API_KEY="your-api-key"
```
### 2. Run the Server
```bash
# Install
pip install -e .
# Run
python -m daily_briefing
```
## Configuration
All configuration via environment variables with `BRIEFING_` prefix:
### Server Settings
| Variable | Description | Default |
|----------|-------------|---------|
| `BRIEFING_TRANSPORT` | Transport mode: `stdio` or `streamable-http` | `stdio` |
| `BRIEFING_HOST` | HTTP server host | `0.0.0.0` |
| `BRIEFING_PORT` | HTTP server port | `8003` |
| `BRIEFING_LOG_LEVEL` | Log level | `INFO` |
| `BRIEFING_TIMEZONE` | Timezone for scheduling | `America/New_York` |
### Calendar Sources
| Variable | Description |
|----------|-------------|
| `BRIEFING_GOOGLE_CALENDAR_URL` | Google Calendar iCal feed URL |
| `BRIEFING_GOOGLE_CALENDAR_NAME` | Display name for Google Calendar |
| `BRIEFING_GOOGLE_CALENDAR_ENABLED` | Enable Google Calendar (default: true) |
| `BRIEFING_TRIPIT_ICAL_URL` | TripIt private iCal feed URL |
| `BRIEFING_TRIPIT_ENABLED` | Enable TripIt (default: true) |
| `BRIEFING_ADDITIONAL_ICAL_URLS` | Comma-separated additional iCal URLs |
| `BRIEFING_ADDITIONAL_ICAL_NAMES` | Comma-separated names for additional sources |
### Fireflies.ai
| Variable | Description |
|----------|-------------|
| `BRIEFING_FIREFLIES_API_KEY` | Fireflies.ai API key |
| `BRIEFING_FIREFLIES_ENABLED` | Enable Fireflies (default: true) |
### Briefing Settings
| Variable | Description | Default |
|----------|-------------|---------|
| `BRIEFING_WORK_START_HOUR` | Work day start hour | `9` |
| `BRIEFING_WORK_END_HOUR` | Work day end hour | `17` |
| `BRIEFING_CONFLICT_BUFFER_MINUTES` | Min buffer between meetings | `15` |
| `BRIEFING_MEETING_LOOKBACK_DAYS` | Days to look back for meetings | `1` |
| `BRIEFING_TRAVEL_LOOKAHEAD_DAYS` | Days to look ahead for travel | `7` |
## Available Tools
| Tool | Description |
|------|-------------|
| `health_check` | Check server health and source connections |
| `get_daily_briefing` | Generate comprehensive daily briefing |
| `get_todays_schedule` | Get today's events and conflicts |
| `get_action_items` | Get pending action items from meetings |
| `get_recent_meetings` | Get summaries of recent meetings |
| `get_upcoming_travel` | Get upcoming travel information |
| `check_availability` | Find available time slots on a date |
| `get_week_overview` | Get overview of the upcoming week |
## Example Usage
### Claude Desktop Configuration
```json
{
"mcpServers": {
"daily-briefing": {
"command": "python",
"args": ["-m", "daily_briefing"],
"env": {
"BRIEFING_GOOGLE_CALENDAR_URL": "https://calendar.google.com/...",
"BRIEFING_TRIPIT_ICAL_URL": "https://tripit.com/feed/...",
"BRIEFING_FIREFLIES_API_KEY": "your-api-key"
}
}
}
}
```
### Example Queries
```
"Give me my daily briefing"
"What's on my schedule today?"
"Do I have any scheduling conflicts?"
"What action items do I have from recent meetings?"
"When am I free for a 1-hour meeting today?"
"What does my week look like?"
"Any upcoming travel?"
```
### Sample Briefing Output
```markdown
# Daily Briefing - Wednesday, January 15, 2025
## Today's Schedule
- **09:00 AM - 09:30 AM** (30m)
- Team Standup
- **02:00 PM - 03:00 PM** (60m)
- Product Review
- *Location:* Conference Room A
## Available Focus Time
- 09:30 AM - 02:00 PM (270m)
## Travel Alerts
✈️ Flight in 3 days: Flight to San Francisco
## Recent Meeting Summaries
### Sprint Planning
*January 14, 2025*
Team discussed sprint goals and assigned tasks.
**Action Items:**
- [ ] Review PR #123
- [ ] Update documentation
## Pending Action Items
- [ ] Review PR #123
- *From: Sprint Planning*
## Today's Stats
| Metric | Value |
|--------|-------|
| Total Meetings | 2 |
| Meeting Time | 1.5 hours |
| Focus Time | 4.5 hours |
```
## Development
### Install Dependencies
```bash
pip install -e ".[dev]"
```
### Run Tests
```bash
pytest
```
### Run with Debug Logging
```bash
BRIEFING_LOG_LEVEL=DEBUG python -m daily_briefing
```
## Docker
```bash
# Build
docker build -t daily-briefing .
# Run
docker run \
-e BRIEFING_GOOGLE_CALENDAR_URL="..." \
-e BRIEFING_TRIPIT_ICAL_URL="..." \
-p 8003:8003 \
daily-briefing
```
## Kubernetes Deployment
```bash
helm install daily-briefing ./helm/daily-briefing \
--set briefing.googleCalendar.url="YOUR_GOOGLE_CALENDAR_URL" \
--set briefing.tripit.icalUrl="YOUR_TRIPIT_URL"
```
## Architecture
```
┌─────────────────────────────────────────────────────────────────┐
│ Daily Briefing MCP Server │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │
│ │ Google │ │ TripIt │ │ Fireflies.ai │ │
│ │ Calendar │ │ (Travel) │ │ (Meetings) │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────────────┘ │
│ │ │ │ │
│ └─────────────────┼──────────────────┘ │
│ │ │
│ ┌──────▼───────┐ │
│ │ Aggregator │ │
│ └──────┬───────┘ │
│ │ │
│ ┌─────────────────┼─────────────────┐ │
│ │ │ │ │
│ ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐ │
│ │ Conflict │ │ Free │ │ Action │ │
│ │ Detection │ │ Slots │ │ Items │ │
│ └───────────┘ └───────────┘ └───────────┘ │
│ │ │
│ ┌──────▼───────┐ │
│ │ Formatters │ │
│ │ (MD/Text/JSON)│ │
│ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
```
## License
MIT
