Support Efficient X · Support this plugin directly

Import iCal/ICS calendar feeds into Tasks-compatible Obsidian tasks.

iCal Importer reads calendar events from iCal feeds, writes them into an Obsidian note, and keeps that note updated when you sync. It is for people who want appointments, school events, shared calendars, reminders, bills, travel dates, and other scheduled commitments visible inside Obsidian without retyping them by hand.

- [ ] Haircut - Friday - 16:00-16:30 📅 2026-08-07 #calendar
- [ ] Rent due - Monday - All day 📅 2026-08-10 #home
- [ ] Reminder: Dentist - Tuesday - 09:00 📅 2026-08-11 #health

Follow the steps below to install iCal Importer from Obsidian's community plugins browser.

1. Search for iCal Importer in Obsidian's community plugins browser.
2. Install the plugin.
3. Enable the plugin in Obsidian settings under Community plugins.
4. Open Settings > iCal Importer.
5. Add an iCal/ICS calendar feed URL.
6. Click Preview to check the imported task output.
7. Click Sync now.

If the plugin is not yet visible in Community Plugins, see manual installation and testing.

Open the plugin settings, add a feed, and paste a private or published iCal/ICS URL from your calendar provider.

Common sources include:

• Google Calendar private iCal links
• Microsoft Outlook and Microsoft 365 published ICS links
• Apple iCloud public calendar links
• Zoho Calendar public or private iCal URLs
• Other calendars that publish standard .ics, webcal://, or iCalendar feed URLs

Private calendar feed URLs should be treated like passwords. Anyone with the URL may be able to read that calendar feed.

By default, iCal Importer writes to:

Calendar/My Calendar Events.md

The plugin manages only its configured calendar section and preserves content outside that section.

iCal Importer works especially well with the Obsidian Tasks plugin. Keep imported events in one calendar note, then query them from daily notes, dashboards, weekly reviews, or project notes.

not done
due today
path includes Calendar/My Calendar Events

For a more focused daily note dashboard:

> [!danger]+ Tasks due today
> ```tasks
> not done
> (due today) OR (scheduled today)
> description regex does not match /^$/
> ```

> [!caution]- Tasks due within 3 days
> ```tasks
> not done
> (due next 3 days AND due - 3 days) OR (scheduled tomorrow)
> description regex does not match /^$/
> ```

• Sync one or more iCal/ICS calendar feeds.
• Render calendar events as Tasks-compatible markdown tasks.
• Preview sync output before writing notes.
• Preserve manually completed tasks.
• Move completed calendar tasks into a completed section.
• Expand recurring events inside a rolling sync window.
• Expand multi-day all-day events into one task per day, or keep them as one task.
• Optionally create reminder tasks from iCal alarms.
• Include locations, descriptions, calendar names, organizers, created dates, and modified dates when feeds provide them.
• Use per-feed colours, tags, source labels, and keyword filters.
• Mask private feed URLs in status and error messages.

iCal Importer helps with Obsidian calendar sync, Google Calendar to Obsidian workflows, Outlook calendar import, iCloud calendar import, ICS to markdown, and calendar events as Obsidian Tasks. It is useful for daily notes, dashboards, task planning, family calendars, school calendars, bills, appointments, travel dates, and recurring reminders.

• Installation and testing
• Settings overview
• Commands
• Privacy and feed URL safety
• Tester checklist
• Development
• Release notes for maintainers

If this plugin saves you time, you can support development through Buy Me a Coffee:

• Buy Me a Coffee: Efficient X
• Support this plugin directly

Built by Efficient X Group.

MIT