Documentation
Everything you need to get started with WhatIDid.ai
Getting Started
WhatIDid.ai is an intelligent productivity tool that automatically analyzes your Gmail, Google Calendar, and Google Drive activity to generate insightful weekly summaries powered by AI.
Prerequisites
- A Google account (Gmail, Calendar, Drive)
- An Anthropic API key — get one at console.anthropic.com
- Python 3.8 or higher
Setup Guide
Step 1: Google API Setup
- Go to Google Cloud Console
- Create a new project or select an existing one
- Enable the following APIs: Gmail API, Google Calendar API, Google Drive API
- Create OAuth 2.0 credentials → "Credentials" → "Create Credentials" → "OAuth client ID" → choose "Desktop app"
- Download the credentials file and save it as
credentials.jsonin the project directory
💡 Tip: WhatIDid.ai only requests read-only access to your data. Your information stays private and secure.
Step 2: Anthropic API Key
- Visit console.anthropic.com
- Create an account or sign in
- Generate a new API key (starts with
sk-ant-) - Add it to your
.envfile:ANTHROPIC_API_KEY=sk-ant-your_api_key_here
Step 3: Install & Run
git clone https://github.com/GitHubBlossom/WID.git
cd WID
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python app.py
Then open http://localhost:5555 in your browser.
Features
Email Analysis
- Number of emails sent and received
- Top contacts you communicated with
- Email subject patterns and themes
Calendar Insights
- Total events and meetings attended
- Time spent in meetings
- Meeting attendees and collaboration patterns
Document Tracking
- Documents created and modified (Docs, Sheets, Slides)
- Recent document activity
AI-Powered Summaries
- Executive summary of your week
- Key meetings and collaborations
- Main projects and focus areas
- Actionable insights and recommendations
Using WhatIDid.ai
Manual Summaries
- Click "Run Analysis Now" for the default period
- Or enter a custom number of days to analyze
- View your summary immediately in the dashboard
Automated Summaries
- Go to Settings
- Choose your preferred day and time
- Enable automatic email delivery (optional)
- Save your settings
Frequently Asked Questions
Is my data secure?
Yes. WhatIDid.ai only requests read-only access to your Google services. All credentials are stored locally, and only summary data is sent to Anthropic's AI for analysis — never full email or document content.
What does it cost?
WhatIDid.ai is free to use. You only need your own Anthropic API key, which has a generous free tier.
Can I customize the analysis period?
Yes — you can analyze any period from 1 to 30 days. The default analyzes yesterday's activity.
How do I disconnect my Google account?
Delete the token.json file from the application directory to revoke access.