Calendar

Pinwork can connect tasks to Apple Calendar when you want scheduled work to live in both places.

Calendar features use Apple’s EventKit system. Pinwork needs Calendar permission before it can create, edit, show, or sync linked calendar events.

Grant Calendar access

Calendar features need full Calendar access.

Pinwork can ask for access from Settings or the first time you use a calendar action. If access is denied or restricted, Pinwork shows Calendar Access Required with an option to open Settings.

Calendar permission prompts are handled one at a time, so you should not see stacked permission dialogs.

Why full access is needed

Pinwork needs enough Calendar access to create linked events, open existing linked events, update them, and show Calendar Peek beside your tasks.

Add a task to Calendar

To create a linked event, use one of these actions:

• task context menu, Calendar > Add to Calendar
• task action bar, Send to calendar
• batch action, Add to Calendar

Pinwork creates an event and stores the event link on the task.

If you have chosen a calendar in Settings, Pinwork uses that calendar for new task events. Otherwise, it uses your default Calendar event calendar when available.

The event can use:

• the task title
• task notes, plus a Pinwork link back to the task
• the task’s When date and time
• the task estimate as event duration
• the task Deadline as a Calendar alarm

If the task has no When date, Pinwork creates the event at the current time with the task estimate or a default one-hour duration.

If the task is overdue and still active, event creation shifts the event to today while preserving explicit time.

Batch add skips tasks that are already linked to calendar events.

Use When first

Set a task’s When date before adding it to Calendar when you want the event at a specific day or time.

Automatically add scheduled tasks

In Settings under Calendar, you can turn on Automatically Add Scheduled Tasks.

When this is enabled, Pinwork creates a linked Calendar event when a task gets a When date. This can happen after scheduling, deferring, dragging in Upcoming, or creating a task with schedule information.

Automatic event creation uses the same target calendar preference as manual Calendar actions. If no target calendar is selected, Pinwork uses the default Calendar event calendar when available.

Pinwork skips automatic event creation when:

• the setting is off
• the task is not scheduled
• the task is already linked to a Calendar event
• Calendar permission is not available

Schedule or edit in Calendar

Use Schedule in Calendar to open the platform calendar editing flow.

On iPhone and iPad, Pinwork opens the native event editor. If the task already has a linked event, the editor opens that event. If the task is not linked yet, the editor starts with a new event prefilled from the task.

On Mac, Pinwork creates a new event and opens Calendar.app for unlinked tasks, or opens the existing event when the task is already linked.

When the event is saved, Pinwork stores the event identifier on the task. It can also update the task estimate from the event duration.

See whether a task is linked

A linked task shows calendar state in the task actions.

You may see:

• the Calendar menu with a checked calendar icon
• the action changing from Send to calendar to Remove calendar link
• a Calendar chip on supported task cards and rows on iPhone, iPad, and Mac

Remove a calendar link

Use Remove Calendar Link from the task’s Calendar menu or action bar.

Important: this removes the linked event from Apple Calendar and clears the calendar metadata from the task. It does not only disconnect the task from the event.

This deletes the Calendar event

Remove Calendar Link removes the linked Apple Calendar event when Pinwork can find it. It is not just an unlink action.

If the event is already missing, Pinwork treats it as removed and clears the task’s link. If permission or removal fails, the link remains and Pinwork asks you to check permissions and try again.

Removing an existing calendar link cannot be undone.

Keep task changes synced to Calendar

After a task is linked, Pinwork can update the Calendar event when relevant task fields change.

Linked event sync can update:

• title
• notes
• When date and time
• estimate
• Deadline alarm

Pinwork preserves any Calendar availability settings you changed in Calendar. If the linked event is missing and full Calendar access is available, Pinwork clears the task’s calendar link.

Let Calendar changes sync back to Pinwork

Pinwork can also read changes from linked Calendar events.

Calendar back-sync can update:

• task title
• notes
• When date and time
• estimate

All-day events update the task to an all-day When date and do not update the estimate.

If both the Pinwork task and the Calendar event changed since the last sync, the task wins and Pinwork writes the task data back to Calendar.

When both sides changed

If the task and the Calendar event both changed since the last sync, Pinwork treats the task as the source of truth.

If a task does not have a When date, Pinwork ignores event timing changes to avoid scheduling it by accident.

Calendar Peek

Turn on Show Calendar Peek in Settings under Calendar to show events beside your tasks in Today and Upcoming.

You can choose specific calendars or use all calendars.

There is also a Show Linked Calendar Events setting. Turn it off if you do not want Pinwork-created or Pinwork-linked events to appear beside their matching tasks.

Avoid duplicates

Turn off Show Linked Calendar Events if Calendar Peek feels duplicated because the same work appears as both a task and a linked event.

Access lock behavior

Calendar actions that create, edit, remove, or sync task-linked events are mutation paths. If Pinwork access is locked, those actions are blocked and the access sheet opens instead.

Related

• Scheduling a task: set When and Deadline before creating events.
• Natural language: include calendar commands in supported parsed capture paths.
• Sync and privacy: how Calendar access fits the privacy model.