README file from
GithubCalendar List
An Obsidian plugin for pulling events from your macOS Calendar app and inserting them directly into your notes. Your agenda is pasted as plain text, with the dates formatted as you want them.
This plugin is actively being developed, so create a GitHub issue if you have any trouble.
Features
Pick a date range — today, this week, next month, whatever — and the plugin fetches your calendar events and drops them into your note as a formatted list. Titles, dates, and times, in whatever format you like.
For example, on the last day of the year, you might get something like:
- New Year's Eve
- 11:00 AM - Brunch with friends
- 8:00 PM - Head out to the NYE party
Inline )) autosuggest
Type )) (or your configured trigger) anywhere in a note to open a range picker inline. Five presets appear immediately — press ↵ or ⇥ to insert, ↑↓ to navigate.
| Preset | What you get |
|---|---|
| Today | Events for today |
| Tomorrow | Events for tomorrow |
| This week | Mon–Sun of the current week |
| Next week | Mon–Sun of next week |
| This month | All events this calendar month |
Insert Calendar Events command
Open the command palette and run Calendar List: Insert calendar events. The same five presets appear in a modal — click or press the matching number to fetch and insert immediately.
Need a custom window? Choose Custom… to enter a specific start and end date.
Output format
Everything about the output is configurable in Settings → Calendar List:
| Setting | Default | Description |
|---|---|---|
| Date format | ddd MMM D |
Moment.js format for the date portion |
| Wiki links | Off | Wrap the date in [[ ]] to link to a daily note |
| Wiki link alias | (blank) | If set, produces [[date|alias]] |
| Time format | HH:mm |
Format for the time portion |
| Date–time separator | , |
Text between date and time |
| Prefix | - |
Text before each event line |
| Title separator | — |
Text between the date/time and event title |
A date format guide with common tokens is included at the bottom of the settings page.
Excluding calendars
Large or slow calendars (Birthdays, Siri Suggestions, subscription calendars) can make fetches sluggish. Add them to the Excluded calendars list in settings to skip them entirely. You can also increase the timeout if you have remote calendars that are just slow.
Requirements
macOS only. Calendar List reads your calendars through a free command-line tool called icalBuddy, which talks to the same EventKit framework that Apple's own apps use. You'll need to install it once before the plugin will work.
Option 1 — Homebrew (recommended)
If you have Homebrew, open Terminal and paste:
brew install ical-buddy
Note: If you don't have Homebrew yet, it's a one-line install and well worth having.
Step 1: Open Terminal (in Applications, or use your spotlight search)
Step 2: Copy and paste the following command into your Terminal and press Return or Enter
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Option 2 — Direct download
Download the latest release directly from the icalBuddy GitHub releases page. Unzip it and move the icalBuddy binary somewhere on your PATH (e.g. /usr/local/bin/).
The first time icalBuddy runs, macOS will ask for permission to access your Calendar. Allow it, and you're set. If you're not sure whether it's working, open Terminal and run icalBuddy eventsToday — you should see today's events listed.
Related plugins
If you like Calendar List, you might also like Date List — a companion plugin for inserting single dates and formatted date lists with a live-preview wizard and inline autocomplete. I also made File Filter, which is a great plugin that lets you filter your notes by a search term.
Feedback and contributions
Let me know if you have any feedback or suggestions!