Schedule to Google Calendar

A Python tool that converts weekly schedules from images or PDFs into Google Calendar events automatically using AI.

Instead of manually typing schedules into your calendar, simply upload a screenshot or PDF of your timetable and the tool will:

1. Extract events using OpenRouter vision models
2. Let you review/edit detected events
3. Automatically create recurring Google Calendar events

---

Features

• File Support: Upload PDF, PNG, JPG, or JPEG schedules.
• AI Parsing: Automatically extracts the timetable structure using OpenRouter-hosted vision models.
• Human-in-the-loop: Interactive JSON correction interface before syncing.
• Smart Filtering: Filters out invalid or empty events.
• Automation: Creates weekly recurring Google Calendar events.
• Secure: Uses official Google OAuth authentication.
• Smart Dates: Automatically detects the next weekday occurrence for the initial event.

---

Installation

Install the Python dependencies:

  pip install -r requirements.txt

1. Get an OpenRouter API Key

Create a key in your OpenRouter dashboard.

Add it directly to your script (or set it as an environment variable):

OPENROUTER_API_KEY="YOUR_API_KEY"

You can also choose the model through OPENROUTER_MODEL. The default is google/gemini-3-flash-preview.

---

2. Enable the Google Calendar API

1. Open the Google Cloud Console.
2. Navigate to APIs & Services → Library.
3. Search for Google Calendar API.
4. Click Enable.

---

3. Create OAuth Credentials

1. Navigate to APIs & Services → Credentials.
2. Click Create Credentials → OAuth Client ID.
3. Select Desktop Application as the application type.
4. Download the resulting JSON file.
5. Rename it to:

credentials.json

6. Place it in your project root folder.