README file from
GithubOutlook to Day Planner Sync
Obsidian plugin that syncs Outlook calendar events into the ## Day Planner section of your daily notes, filtered by the note's frontmatter Date property.
Features
- Downloads events from a published Outlook calendar (
.icsfeed) - Filters events by the active note's frontmatter
Dateproperty - Inserts or updates the
## Day Plannersection with checkbox tasks - Sorts events by start time
- Supports recurring events and configurable timezones
- Accessible from the ribbon icon or command palette
Requirements
- Obsidian 1.13.0 or later
- A published Outlook calendar (
.icslink) - Daily notes with a
Dateproperty in frontmatter (YYYY-MM-DD)
Installation
From the community (if published)
- Open Settings → Community plugins
- Search for Outlook to Day Planner Sync
- Enable the plugin
Manual installation
- Copy the
outlook-syncfolder into.obsidian/plugins/in your vault - Run
npm installandnpm run buildinside the plugin folder - Enable the plugin under Settings → Community plugins → Installed plugins
Usage
- Open a daily note with a
Dateproperty in frontmatter:
---
Date: 2026-08-27
---
-
Run sync using one of these methods:
- Click the calendar icon in the left ribbon
- Open the command palette (
Cmd/Ctrl + P) and search for Sync Outlook to Day Planner
-
The plugin updates the note's
## Day Plannersection with that day's events:
## Day Planner
- [ ] 09:00-10:00 - Team meeting
- [ ] 14:30-15:00 - Project review
If there are no events for that date:
- [ ] No events scheduled for this day
If the ## Day Planner section does not exist, it will be created at the end of the note.
Note format
| Requirement | Description |
|---|---|
Frontmatter Date |
Required. Format YYYY-MM-DD (e.g. 2026-08-27) |
Section ## Day Planner |
Optional. If it exists, its content is replaced; otherwise it is appended |
Settings
Open Settings → Outlook to Day Planner Sync and configure:
- Calendar URL (.ics) — Your Outlook calendar feed URL
- Timezone — IANA name (e.g.
America/Bogota) or fixed offset (e.g.-05:00) - Start hour / End hour — Filter which events are included
You can paste .ics or .html URLs; HTML links are converted automatically:
| Format | URL |
|---|---|
| HTML (web view) | .../owa/calendar/.../calendar.html |
| ICS (feed) | .../owa/calendar/.../calendar.ics |
Settings are saved automatically when you edit each field.
Development
# Install dependencies
npm install
# Production build
npm run build
# Development mode (rebuilds on save)
npm run dev
To test changes in Obsidian, reload the plugin from Settings → Community plugins → Installed plugins (disable and re-enable) or restart Obsidian.
Project structure
outlook-sync/
├── main.ts # Plugin source code
├── main.js # Generated bundle (do not edit)
├── manifest.json # Plugin metadata
├── esbuild.config.mjs # Build configuration
├── tsconfig.json # TypeScript configuration
└── package.json
License
MIT