Support for belki.

Connect button is unavailable

1. Confirm that you are using the current desktop release of Obsidian and the latest belki release.
2. Open belki settings and check that the Google Calendar integration is available in your installed version.
3. Reload Obsidian after updating the plugin.

If the option is still missing, check the release notes and open a GitHub issue with your belki, Obsidian, and operating-system versions.

Google Calendar connection is desktop-only in the current MVP

The current OAuth connection flow must be started from Obsidian on desktop. Do not expect the Connect button to complete authorization on mobile in this version. This limitation applies to Google Calendar authorization, not to all belki task features.

Browser opens but authentication does not complete

1. Keep Obsidian open while completing the Google authorization page.
2. Finish the flow in the same browser window that belki opened.
3. Return to Obsidian and wait briefly for connection status to update.
4. If the browser shows an error or Obsidian does not update, cancel, restart Obsidian, and try once more.

When reporting the problem, include the visible error text but never include the authorization code or tokens.

No calendars appear

1. Confirm that the connection status shows the intended Google account.
2. Use the calendar refresh action in belki settings.
3. Check that the account has at least one calendar visible in Google Calendar.
4. Disconnect and reconnect only if a normal refresh does not restore the list.

Events do not appear in Today or Upcoming

1. Make sure the source calendar is selected as visible in belki settings.
2. Check the event date, time zone, and whether it falls within the date section you are viewing.
3. Refresh calendar data, then reopen Today or Upcoming.
4. Open Google Calendar directly to confirm that the event still exists.

Calendar events appear above task rows. They do not appear as belki tasks or in task Markdown files.

A calendar is hidden

Open belki settings, find the list of available calendars, and enable that calendar. Return to Today or Upcoming and refresh if the change is not immediately visible.

Refresh fails

1. Confirm that the device is online and Google Calendar is reachable in your browser.
2. Try the refresh action again after a short interval.
3. If the connection shows an authorization error, disconnect and reconnect the integration.

A temporary Google API, network, or account problem may require waiting before trying again.

Access was revoked

If you removed belki from your Google Account permissions, the stored connection can no longer retrieve events. Disconnect Google Calendar in belki settings, then connect again if you want to restore read-only access.

Disconnecting Google Calendar

1. Open belki settings in Obsidian.
2. Find Google Calendar and choose Disconnect.
3. Confirm that the connection status is cleared.
4. Optionally revoke access from your Google Account permissions page.

Disconnecting clears the OAuth credentials stored locally by belki. Your Google Calendar events are not deleted or changed.

Calendar events are not copied into task Markdown files

This is expected behavior. belki reads selected calendar events for display in memory. It does not convert them into tasks or permanently write event titles, times, or other event data into belki task Markdown files.