A B30 downloadsSee a day of your Outlook calendar in a sidebar and drag events into notes. Follows your daily note. Read-only.
A sidebar in Obsidian that shows one day of your Outlook calendar. Drag an event into a note to insert it as a Markdown line: it lands on a line of its own, indented like the line you dropped it on. Or use an event's + button to add it below the cursor. The command Insert the day's agenda adds every event of the day at once.
A note line holds an event when, trimmed, it is exactly what adding the event
would insert (its first line, for a template of several lines), or when it
is a list item whose text is the event's time and title, such as
- 09:00–10:00 Standup or - [ ] 09:00 standup. Case, extra spaces, the
kind of dash and a tail of tags, dates, emojis and links do not count. A title alone, such as - Standup, does not match. The icons cover
the days the panel has shown or read from its cache since Obsidian started.
When a line matches an event on several days, as a recurring one does, the
icon shows the one on the note's own day if it is a daily note, else the
panel's day, else the one nearest to today.
The plugin only reads your calendar. It never creates, changes or answers anything in Outlook.
This plugin is not made by or affiliated with Microsoft. Outlook is a trademark of Microsoft.
The plugin is built not to slow Obsidian down:
main.js.To check, open Settings → Community plugins and use Obsidian's startup time report.
login.microsoftonline.com to sign in and graph.microsoft.com to read
your calendar. Nothing is sent anywhere else.data.json in
your vault.The plugin signs in to Microsoft itself. It needs an app registration in Microsoft Entra so that Microsoft knows which app is asking. You register your own, once.
Already use the Microsoft To Do Panel plugin? You can reuse its app registration: add the Calendars.Read permission to it (step 7), then enter the same client ID and tenant here. You still sign in once in this plugin, because each plugin keeps its own sign-in.
consumers for personal accounts only, or
common for both.Open the panel from the ribbon icon or with the command Outlook Calendar Panel: Open panel.
| Message starts with | Fix |
|---|---|
AADSTS50059 |
Set Tenant to your directory (tenant) ID. |
AADSTS700016 |
Check the client ID and tenant. |
AADSTS7000218 |
Turn on Allow public client flows in the app registration. |
AADSTS65001 |
The permission is not granted yet; an administrator may need to approve it. |
Some organisations block device code sign-in altogether. If yours does, the plugin cannot sign in there.
Requires Obsidian 1.11.4 or newer, for secret storage.
Au2mater/obsidian-outlook-calendar-panel.main.js, manifest.json and styles.css from the
latest release into <vault>/.obsidian/plugins/outlook-calendar-panel/,
then enable the plugin under Settings → Community plugins.The settings tab shows your Microsoft account and the event template. The rest is under Advanced, collapsed.
| Setting | Default | Notes |
|---|---|---|
| Client ID | empty | From your app registration. |
| Tenant | common |
Tenant ID, common, organizations or consumers. |
| Event template | - {{time}} {{title}} |
{{time}}, {{start}}, {{end}}, {{title}}, {{date}}, {{location}}, {{organizer}}, {{calendar}}, {{link}}, {{join}} |
| Time format (advanced) | HH:mm |
Moment.js format, such as h:mm A. |
| Daily note date format (advanced) | YYYY-MM-DD |
Moment.js format of daily note file names. |
| Follow the daily note (advanced) | on | Show the day of the daily note you open. |
| Show declined events (advanced) | off | Shown struck through. |
| Refresh after (advanced) | 15 minutes |
How old a shown day may get before it is fetched again. |
| Permissions (advanced) | Calendars.Read |
Microsoft Graph permissions to ask for. |
{{time}} is 09:00–10:00, All day, From 22:00 or Until 06:00.
{{link}} opens the event in Outlook on the web, and {{join}} is its online
meeting link. Placeholders with nothing to fill in disappear, with the spaces
around them.
The panel shows your default calendar until you choose others under Calendars in the settings, which lists your own calendars and the ones shared with you, each with its Outlook colour. Events show a stripe in their calendar's colour, and with more than one calendar chosen, the calendar's name. A calendar that cannot be read is named above the events, and the others still show.
Calendars shared with you by someone else may need the Calendars.Read.Shared permission: add it to the app registration and to Permissions under Advanced, then sign in again.
Plain JavaScript with no dependencies. The source is src/plugin.js;
npm run build checks it and writes main.js, the file Obsidian loads.
./install.sh "/path/to/vault/.obsidian" # builds, then copies
npm test
The tests load src/plugin.js against a small stand-in for the Obsidian API.
They cover startup cost (no request and no secret read on load, no fetch
before the layout is ready or while the panel is hidden), sign-in, token
refresh, day windows across summer time changes, all-day and multi-day
events, the cache, following the daily note, inserting events, matching note
lines to events, the editor icons and showing an event from a note.
To release, bump version in manifest.json and package.json, add it to
versions.json and commit. Push the tag first and the branch once the release
exists:
git tag 1.0.0 && git push origin 1.0.0 # the workflow builds and publishes
git push origin main