Summary MCP

# Summary MCP > AI-powered daily and weekly productivity summaries from Slack, Calendar, and Gmail An MCP (Model Context Protocol) server that provides comprehensive productivity summaries by analyzing your Slack messages, Calendar events, and Gmail activity. ## 🌟 Features - **📅 Daily Summaries**: Concise end-of-day wrap-ups with tomorrow's preview - **📊 Weekly Summaries**: Comprehensive 7-day productivity analysis - **⚡ Quick Stats**: Fast metrics without full summary generation - **📈 Period Comparison**: Compare productivity across different weeks - **📁 File Management**: List and retrieve past summaries - **🤖 Automated Generation**: Scheduled daily (Mon-Fri 8:30 AM) and weekly (Mon 9:00 AM) summaries - **🚫 Smart Filtering**: Automatically excludes personal conversations (sports, politics, entertainment) ## 🚀 Quick Start ### Installation 1. **Clone and setup**: ```bash cd ~/shopify-projects git clone <repo-url> summary-mcp cd summary-mcp npm install ``` 2. **Configure Cursor MCP**: Add to `~/.cursor/mcp.json`: ```json { "mcpServers": { "summary-mcp": { "type": "stdio", "command": "node", "args": ["/Users/philipbloch/shopify-projects/summary-mcp/src/index.js"], "env": {} } } } ``` 3. **Install Automation** (optional): ```bash ./scripts/install-automation.sh ``` This sets up: - Daily summaries: Monday-Friday at 8:30 AM PT - Weekly summaries: Mondays at 9:00 AM PT ## 📖 Available Tools ### 1. `generate_daily_summary` Generate a concise daily productivity summary. **Parameters**: - `date` (optional): Date in YYYY-MM-DD format (default: today) - `output_format`: `html`, `markdown`, `both`, or `json` - `save_to_file`: Whether to save to summaries folder (default: true) - `include_sections`: Array of sections to include **Example**: ``` Generate my daily summary and save to summaries folder ``` ### 2. `generate_weekly_summary` Generate a comprehensive weekly productivity summary. **Parameters**: - `days_back` (optional): Number of days to analyze (default: 7) - `start_date` / `end_date` (optional): Custom date range - `output_format`: `html`, `markdown`, `both`, or `json` - `save_to_file`: Whether to save to summaries folder (default: true) **Example**: ``` Generate my weekly summary for the last 7 days ``` ### 3. `get_quick_stats` Get quick productivity metrics without generating a full summary. **Parameters**: - `days_back` (optional): Number of days to analyze (default: 7) - `start_date` / `end_date` (optional): Custom date range **Example**: ``` Show me quick stats for the past week ``` ### 4. `list_summaries` List previously generated summaries. **Parameters**: - `limit`: Max results (default: 10) - `sort`: `newest` or `oldest` - `format`: Filter by `html`, `markdown`, or `all` ### 5. `get_summary` Retrieve a specific summary by filename or date range. **Parameters**: - `filename`: Specific summary file - `start_date` / `end_date`: Find by date range - `format`: Return `html`, `markdown`, or `both` ### 6. `compare_periods` Compare productivity between two time periods. **Parameters**: - `period1`: { start_date, end_date } - `period2`: { start_date, end_date } - `metrics`: Array of metrics to compare ## 📁 Project Structure ``` summary-mcp/ ├── src/ │ ├── index.js # MCP server entry point │ ├── config.js # Configuration │ ├── tools/ │ │ ├── index.js # Tool definitions │ │ ├── handler.js # Tool routing │ │ ├── generate-daily-summary.js │ │ ├── generate-summary.js │ │ ├── list-summaries.js │ │ ├── get-summary.js │ │ ├── quick-stats.js │ │ └── compare-periods.js │ ├── analyzers/ │ │ ├── slack-analyzer.js │ │ ├── calendar-analyzer.js │ │ └── gmail-analyzer.js │ └── utils/ │ ├── date-utils.js │ └── file-utils.js ├── scripts/ │ ├── generate-daily-summary.sh │ ├── generate-weekly-summary.sh │ ├── install-automation.sh │ └── uninstall-automation.sh ├── summaries/ # Generated summaries ├── logs/ # Automation logs ├── com.philipbloch.dailysummary.plist ├── com.philipbloch.weeklysummary.plist └── package.json ``` ## 🤖 Automation ### Schedules - **Daily Summary**: Monday-Friday at 8:30 AM PT - **Weekly Summary**: Mondays at 9:00 AM PT ### Managing Automation **Install**: ```bash ./scripts/install-automation.sh ``` **Uninstall**: ```bash ./scripts/uninstall-automation.sh ``` **Check Status**: ```bash launchctl list | grep philipbloch ``` **View Logs**: ```bash # Daily summary logs tail -f logs/daily-summary-*.log # Weekly summary logs tail -f logs/weekly-summary-*.log # LaunchD logs tail -f logs/launchd-daily.out.log tail -f logs/launchd-weekly.out.log ``` ### Manual Trigger **Daily Summary**: ```bash ./scripts/generate-daily-summary.sh ``` **Weekly Summary**: ```bash ./scripts/generate-weekly-summary.sh ``` ## 🛠️ Development ### Running the Server ```bash # Start the server npm start # Development mode with auto-reload npm run dev ``` ### Testing ```bash npm test ``` ### Debug Mode Set `DEBUG=true` in your environment to enable detailed logging: ```json { "mcpServers": { "summary-mcp": { "type": "stdio", "command": "node", "args": ["/Users/philipbloch/shopify-projects/summary-mcp/src/index.js"], "env": { "DEBUG": "true" } } } } ``` ## 📊 Data Sources The MCP server integrates with: 1. **Slack MCP**: Messages, threads, reactions 2. **Google Calendar**: Events, attendees, meeting duration 3. **Gmail**: Emails, threads, important contacts ## 🚫 Content Filtering By default, Summary MCP filters out personal conversations about sports, politics, and entertainment to keep your summaries focused on work. - **Enabled by default** - Only work-related content in summaries - **Easily toggle** - Set `CONTENT_FILTERING_ENABLED=false` in `.env` to disable - **Customizable** - Add your own keywords and topics to filter See [FILTERING.md](./FILTERING.md) for complete documentation. ## 🎨 Output Formats ### Format Generation Rules **Daily & Weekly Summaries**: Generate both `.html` and `.md` by default - Can optionally generate JSON for programmatic access - Default: `output_format: 'both'` **Period Comparisons**: Generate both `.html` and `.md` only (no JSON) - Optimized for human-readable trend analysis - Default: `output_format: 'both'` ### HTML Professional, Shopify-branded styling with: - Syntax highlighting - Interactive sections - Visual metrics - Print-friendly layout - Perfect for sharing and presentations ### Markdown Clean, portable text format: - Easy to edit - Version control friendly - Great for notes and documentation - Plain text searchable ### JSON (Daily/Weekly only) Structured data for: - Programmatic access - Custom processing - Integration with other tools - Not available for comparisons ## 🔒 Privacy All data processing happens locally. The MCP server: - ✅ Reads data from your connected services - ✅ Processes summaries locally - ✅ Saves to your local filesystem - ❌ Never sends data to external services - ❌ No cloud processing or storage ## 🐛 Troubleshooting ### Automation not running? 1. Check if jobs are loaded: ```bash launchctl list | grep philipbloch ``` 2. Check logs: ```bash tail -f logs/launchd-daily.err.log tail -f logs/launchd-weekly.err.log ``` 3. Verify Cursor is running (required for automation) ### Summaries not saving? Ensure the `summaries` directory exists: ```bash mkdir -p ~/shopify-projects/summary-mcp/summaries ``` ### MCP server not responding? 1. Restart Cursor 2. Check MCP config in `~/.cursor/mcp.json` 3. Verify Node.js is installed: `node --version` ## 📝 License MIT ## 👤 Author Philip Bloch <philip.bloch@shopify.com> --- **Need Help?** Check the [AUTOMATION.md](./AUTOMATION.md) for detailed automation setup and troubleshooting.