Google Calendar

Manage your Google Calendar from inside Obsidian

Features

• List Events
• Create Events
• Edit Events
• Delete Events
• Auto create Notes from Events
• Insert Links to Events into Notes

Installation

• One click install from community plugin store
• Go to settings and activate plugin
• Go into plugin settings
• Create a own OAuth client (The public test client is full and will not work anymore)
• Press Login and authenticate with google

Create a own OAuth client (its easy)

Here is a step by step guide describing the process with images.

• Create Google Cloud Project
• Activate Google Calendar API
• Configure OAUTH screen
  • Select Extern
  • Fill necessary inputs
  • Add your email as tester if using "@gmail" add gmail and googlemail
• Add OAUTH client
  • select Webclient
  • add http://127.0.0.1:42813 as Javascript origin
  • add https://google-auth-obsidian-redirect.vercel.app as Javascript origin (only required if you want to use the plugin on mobile)
  • add http://127.0.0.1:42813/callback as redirect URI
  • add https://google-auth-obsidian-redirect.vercel.app/callback as redirect URI (only required if you want to use the plugin on mobile)
• Switch on Use own authentication client in the settings tab
• add the keys into the fields under the plugin settings
• Press Login

Usage

Views

Web View

A webframe to the original google calendar page

Month view

A calendar based on the obsidian-calendar-ui to display events over a month

Day view

A timeline view to see all events over a day

Week view

A timeline view to see all events over a week

Year view

A Github like calendar view to see all events over a year

Schedule view

A schedule view to see all your event in a order

Commands

@Annotation

Reference Google Calendar events inside text by typing @today or @01.01.2022 then select the event you want to insert.

Other Options are @tomorrow, @yesterday, @+1 @-1

CodeBlock

This plugin adds a custom codeBlock gEvent to insert the Web, Day, Week, Month, year and schedule view inside file. To options are parsed with yaml. You can use the settings from the views to copy the configuration as a codeblock.

Parameters

    ```gEvent
        type: [web, month, day, schedule] necessary
        date: [today, tomorrow, yesterday, A specific date] optional
        width: number optional
        height: number  optional
        navigation: boolean optional only for timeline view
        timespan: number optional only for schedule view
        include: [list of calendar ids or names]
        exclude: [list of calendar ids or names]
        theme: [light, dark, auto] only for web view
        hourRange: [start, end] only for day view
    ```

Instead of declaring the parameters directly javascript can be used to set them dynamically. Signal a javascript expression by using ; as prefix and suffix. Example:

```gEvent
type: week
date: ;window.moment().startOf("week");
navigation: true
```

Auto create Notes

The plugin allows you to generate notes automatically from Google Events.

1. To achieve this, activate it inside the settings.
2. Select an Import date range. This is the range in which events are checked. The center is always today.
3. Google events that contain :obsidian: inside the description will create new notes if the plugin starts

You can also define a template that should be used when creating new notes by adding the template title :obsidian-UniTemplate: Make sure to activate the core plugin Templates or the Templater plugin.

You can also define a position where the new note should be saved by adding the folder location in front of the text like this :Folder/Path-obsidian:

Example :Uni/Math-obsidian-UniTemplate: Create the node in the folder Math with the Template UniTemplate.

To insert event information into templates use {{gEvent.AnyField}} for both plugins

Example

Event Description

{{gEvent.description}}

The fields to use are defined in the Google Calendar API and can be selected from the dropdown menu

Inserting a template strings into a file that already has an inserted event using @Annotation will automatically replace the template with the event information.

Use daily notes

To make this plugin a one stop solution for calendars in obsidian you can enable the setting Show daily notes. This will allow you to see your daily notes and google events inside the month view and will add the option to view or create a daily note when opening an event select.

Thank you to the following plugins:

obsidian-calendar-plugin

Obsidian Custom Frames

Hotkeys for templates

obsidian-periodic-notes

Sponsor

If you like the plugin maybe 👉👈