Tasks Plugin Integration¶
Unlock powerful task management by integrating the Obsidian Tasks plugin directly into Full Calendar. This calendar source transforms your tasks into schedulable events with a dedicated backlog and full create, read, update, and delete (CRUD) support.
Best for...
Users of the Obsidian Tasks plugin who want to visualize, schedule, and manage their tasks on a calendar. It's perfect for time-blocking and ensuring that important to-dos get the attention they deserve.
Requires Obsidian Tasks Plugin
This calendar source requires the Obsidian Tasks plugin to be installed and enabled in your vault.
Setup¶
- In Full Calendar settings, go to the Calendars section.
- Click New Calendar and select the type Tasks.
- Give the calendar a name (e.g., "My Tasks") and assign it a color.
Once added, Full Calendar will automatically discover all tasks from your vault and display them.
Advanced Settings¶
Access the tasks Plugin Integration specific settings at (only visible if the Tasks Calendar is added).
Settings -> Integrations -> Tasks Plugin Integration
Features¶
The Tasks calendar is more than just a read-only view; it's a fully interactive task management system.
Task Backlog¶
Once a Tasks Calendar is active, a new Tasks Backlog panel will be registered in sidebar (access it using Command Pallette), listing all unscheduled tasks. From here, you can drag and drop tasks directly onto the calendar to schedule them.
- Drag-and-Drop Scheduling: Quickly schedule tasks by dragging them from the backlog to a specific date and time.
- Filtering: Use the filter bar to narrow down tasks by status (
todo,done) or by the file path they belong to. - Backlog Filter Date Field: Choose whether the backlog is organized around missing scheduled dates, start dates, or due dates. The same setting is available from Settings -> Integrations -> Obsidian Tasks Integration and from the dropdown at the top of the Tasks Backlog panel.
Backlog Filter Date Field¶
The Tasks Backlog filter is driven by a single date-field setting:
| Setting | Backlog shows |
|---|---|
| Scheduled date | Tasks without a scheduled date |
| Start date | Tasks without a start date |
| Due date | Tasks without a due date |
Changing the dropdown in either Settings or the Tasks Backlog panel refreshes open backlog panels immediately. This means the backlog can be used as a focused queue: for example, set it to Due date when you want to review every task that still needs a deadline, even if some of those tasks already have scheduled dates.
What the Calendar Shows¶
The backlog filter date field does not decide where Tasks events appear on the calendar. Calendar display is controlled by Calendar display date field in Settings -> Integrations -> Obsidian Tasks Integration.
| Calendar display setting | Calendar shows tasks with | Dragging from backlog writes |
|---|---|---|
| Scheduled date | A scheduled date | ⏳ YYYY-MM-DD |
| Start date | A start date | 🛫 YYYY-MM-DD |
| Due date | A due date | 📅 YYYY-MM-DD |
Full Calendar uses the selected calendar display field exactly. There is no fallback priority. For example, if Calendar display date field is set to Due date, a task with only a scheduled date will not appear on the calendar until it also has a due date.
Changing the calendar display field may require restarting Obsidian or reloading the plugin before every open calendar view and provider cache reflects the new policy.
The backlog filter and calendar display field can be different. For example, you can set the backlog to show tasks missing due dates while the calendar displays scheduled dates. In that setup, dragging from the backlog writes the calendar display field, not the backlog filter field.
By default, both settings use Scheduled date for backward compatibility. Dragging from the backlog schedules the task without opening the Tasks edit modal. You can enable Open Tasks edit modal after backlog drop from the Tasks integration settings if you want to review the task immediately after dropping it onto the calendar.
Full CRUD Support¶
You can manage your tasks without ever leaving the calendar interface.
- Create: Create new tasks by clicking on the calendar or using the "Add Event" button.
- Read: View all your scheduled and unscheduled tasks.
- Update: Reschedule tasks by dragging them to a new time slot. Edit task details by clicking on the task to open the event editor. Mark tasks as complete by checking the box next to them.
- Delete: Remove tasks from your calendar and your vault.
All changes are synced back to the Tasks plugin in real-time.
Time Blocks¶
You can schedule a task to a specific time—or a time range—by embedding a time block directly in the task's title. Full Calendar reads this block to position the task on the timed calendar view.
In the calendar view, you can also drag and drop tasks between the "all day" area and the timed calendar view.
Supported formats:
| Format | Example | Result |
|---|---|---|
| Single time (24h) | (14:30) |
Event starts at 2:30 PM |
| Time range (24h) | (9:00-10:30) |
Event from 9:00 AM to 10:30 AM |
| Single time (12h) | (2:30 PM) |
Event starts at 2:30 PM |
| Time range (12h) | (9:00 AM-10:30 AM) |
Event from 9:00 AM to 10:30 AM |
A complete task line with a time block looks like this:
- [ ] Review meeting notes (14:00-15:00) ⏳ 2025-03-28
The time block is placed before the configured calendar display date marker in the task description. With the default Scheduled date display policy, that means before ⏳. If you switch the display policy to Due date or Start date, timed calendar edits place the time block before that selected marker instead. When you drag a task to a time slot on the calendar, the time block is written back automatically. Editing the event start/end time from the calendar view will update the embedded time block in the markdown file in real time.
Time Format Setting
Full Calendar reads time blocks in both 12-hour and 24-hour format. It writes time blocks in the format specified under Settings → Appearance.
Advanced Parsing and Settings¶
The integration is built with flexibility in mind.
- Multi-day Events: The provider correctly parses tasks that span multiple days.
- Custom Statuses: The plugin's parser can detect custom task statuses.
- Title Cleaning: A setting is available to automatically strip tags from task titles for a cleaner look on the calendar.
- Tasks Integration Settings: The Integrations section appears only after a Tasks calendar source exists. Its options control backlog filtering, calendar display date policy, and whether the Tasks edit modal opens after backlog drag-and-drop.