Skip to content

Repository files navigation

logseq-google-agenda

Read-only Google Calendar and journal task month view for Logseq using public or private iCal URLs.

Features

  • Import one or more Google Calendar feeds from public or private .ics URLs.
  • Render separate Calendar and Tasks month tabs inside the Logseq plugin main view.
  • Show imported iCal events in Calendar and open Logseq journal-page tasks in Tasks.
  • Use a reference-inspired month layout with a consistent month grid for both tabs.
  • Show a selected-day sidebar with event title, calendar name, and time.
  • Show weather icons for the current day and next 7 days directly in the month grid.
  • Show selected-day weather details in the sidebar header instead of a tooltip.
  • Open or focus the plugin panel from the command palette or Ctrl+Shift+G / Cmd+Shift+G, and close it from the panel close control.
  • Refresh from the command palette.
  • Refresh automatically on the configured interval and keep the last snapshot cached locally.
  • No OAuth flow, event editing, or calendar CRUD support.

Screenshot

  • Design/Layout

Installation

  1. Clone this repository.
  2. Run npm install.
  3. Run npm run build.
  4. In Logseq, open Plugins -> Load unpacked plugin.
  5. Select this repository folder.

Logseq loads the plugin UI from the built dist/ assets, so rebuild after local code changes.

Settings

The plugin registers these Logseq settings:

  • Calendar feeds: JSON array of feed objects with url, calendarName, and optional color.
  • Refresh interval (minutes): positive number used for the automatic refresh loop.
  • Weather city: city name used for Open-Meteo geocoding; leave blank to disable weather.
  • Weather refresh interval (minutes): positive number used for the automatic weather refresh loop.

Example Calendar feeds value:

[
	{
		"url": "https://calendar.google.com/calendar/ical/.../basic.ics",
		"calendarName": "Team",
		"color": "#3b82f6"
	},
	{
		"url": "https://calendar.google.com/calendar/ical/.../private-abcdef/basic.ics",
		"calendarName": "Personal"
	}
]

Notes:

  • The plugin reads calendar data from iCal feeds only.
  • Feed fetch failures are shown in the sync-issue banner without dropping healthy feeds.
  • Weather uses the public Open-Meteo geocoding and forecast APIs and does not require an API key.
  • Weather refresh is best-effort and does not block calendar or task refresh.
  • The current plugin entrypoint runs journal export during refresh and writes managed child blocks under Google Agenda on journal pages.

Usage

  • Open the plugin panel in Logseq.
  • Use Open Google Agenda from the command palette or press Ctrl+Shift+G / Cmd+Shift+G to show and focus the panel, and use the panel close control to dismiss it.
  • Switch between the Calendar tab for imported iCal events and the Tasks tab for open tasks collected from Logseq journal pages.
  • Use Prev, Next, and Today to move around the reference-inspired month grid.
  • The current day and next 7 days can show weather icons in the month grid.
  • Click any day to inspect its events and weather details in the right sidebar header.
  • Use Refresh Google Agenda from the command palette to fetch the latest data.
  • Empty days show No data in the sidebar.

Development

  • npm run test
  • npm run typecheck
  • npm run build
  • npm run dev starts the Vite dev server for local UI work.

Reference

About

Fetch Google Agende events into logseq

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages