A small service, written in Go, that helps Tana get your Calendar for the day. Provides an API you can call from Tana.

Only works on Mac for now since it relies on Apple's Calendar.app and associated API to fetch the calendar data. If Calendar.app is configured to synchronize calendars from iCloud, Google and/or Microsoft Office, this will see all that data.

See also the Tana Template for more info.

Grab the latest release zip from github in the Releases area.

When you unzip the directory, you'll have a directory tana-calendar-helper containing three files

tana-calendar-helper The server program. A compiled Go universal binary. scripts/getcalendar.swift The helper script that talks to Apple's Calendar API scripts/calendar_auth.scpt Another small helper that prompts for permission to access the Calendar data

Put this folder wherever you like and then, open a new Terminal window and cd to the directory.

If you aren't familiar with using Terminal, then in the Finder, you can choose "Show Path Bar" from the View menu. Open the folder in the Finder and then right-click on the folder name in the path bar at the bottom of the window. You should see an option "Open in Terminal. This will open a terminal already in the right folder.

You launch the service on a command line by just typing the name and hitting enter:

./tana-calendar-helper

The service will startup and begin listening for API calls on port 4096

You can also provide a different port number like this:

./tana-calendar-helper -port 8192

Whenever you start the service, you may get a permission box from Mac OS asking you to grant network access to the service. You need to Allow this.

You can test that the service is working by going to the following URL in your browser:

http://localhost:4096/ (or whatever port you are using)

If successful, you should get back a page of Usage instructions.

The first time you run this service and access the actual /calendar endpoint successfully, you will get another permissions dialog asking you to authorize access to your calendars. This is a one-time thing but if you don't allow it, you may be stuck and unable to retrieve data thereafter!

Please see the Tana Template here: Tana Calendar Helper

Or set up a command node like this:

The Calendar API only works when run as a localhost service on a Mac since it relies on your Apple Calendar configuration to act as a "gateway" to your calendar services. This does allow it to reach iCloud, Google and Office365 calendars however.

The /calendar endpoint will by default return you a list of your meetings for today from a calendar named "Calendar".

You can change things with the following JSON payload. All fields are optional.

{
  "me": "self name", // your own name to avoid adding you as an attendee
  "meeting": "#tag", // the tag to use for meetings
  "person": "#tag", // tag for people / attendees
  "solo": true | false, // include meetings with just one person (yourself?)
  "one2one": "#tag", // tag for 1 to 1 meetings
  "calendar": "Calendar",
  "offset": -n | 0 | +n  // how many days before or after today to start from
  "range": >= 1 // how many daysto retrieve. Defaults to 1
}

For my own use, here's what I pass as payload, in my Tana Command node.

See the scripts/getcalendar.swift script for more details.

The most common cause of problems is that you ask for a calendar that does not exist. The script defaults to Calendar as the name of your calendar. You can change this by passing "calendar": "<your calendar name>" in the JSON payload.