📅 YiskiCal/Help
Log in

Help & connection guides

YiskiCal brings all your calendars together in one view. This page explains how to connect each supported calendar type and how sharing works.

Read-only by design: YiskiCal only reads events from your connected calendars. It never creates, edits or deletes anything in Google, Outlook or Odoo. Disconnecting a calendar only removes its cached copy from YiskiCal.
  1. 1
    Create an account
    Sign up with your name, email and a password (at least 8 characters).
  2. 2
    Connect your calendars
    Open Connections and add Google, Outlook or Odoo accounts — as many of each type as you like. See the guides below.
  3. 3
    Check your dashboard
    The Calendar page overlays all connected calendars and your timeblocks, color-coded, in month or week view.

🟦 Connect Google Calendar

  1. 1
    Open the Connections page
    Go to Connections and click Connect Google.
  2. 2
    Choose your Google account
    You'll be redirected to Google. Pick the account you want to connect and sign in if needed.
  3. 3
    Approve read-only access
    Google shows the permissions YiskiCal asks for — only "See events on all your calendars". Click Allow.
  4. 4
    Done
    You're sent back to YiskiCal and the account's events (from every calendar it can read) appear on your dashboard. Repeat with another Google account any time.
You can connect multiple Google accounts — just click Connect Google again and pick a different account. Each one shows up as its own calendar with its own color.

🟪 Connect Outlook / Microsoft 365

  1. 1
    Open the Connections page
    Go to Connections and click Connect Outlook.
  2. 2
    Sign in with Microsoft
    Works with both personal accounts (outlook.com, hotmail.com) and work/school Microsoft 365 accounts.
  3. 3
    Approve read-only access
    YiskiCal requests only "Read your calendars". Click Accept.
  4. 4
    Done
    Events from all calendars on the account appear on your dashboard. You can connect several Microsoft accounts side by side.
Using a work or school account? Some organizations restrict which apps may access calendars. If Microsoft shows a "Need admin approval" screen, ask your IT administrator to approve YiskiCal for your organization.

🟩 Connect Odoo

Odoo connections don't need any server configuration — you connect with your own Odoo API key.

  1. 1
    Create an API key in Odoo
    In Odoo, click your avatar (top right) → My Profile (or Preferences) → Account Security tab → API Keys → New API Key. Give it a name like "YiskiCal", and copy the key immediately — Odoo shows it only once.
  2. 2
    Find your server URL and database name
    The URL is what you see in the browser, e.g. https://mycompany.odoo.com. On Odoo Online the database name is usually the subdomain (mycompany). Self-hosted admins can check the database selector at /web/database/manager.
  3. 3
    Connect in YiskiCal
    On Connections, click Connect Odoo and fill in the server URL, database name, your Odoo login (usually your email) and the API key. Optionally give the connection a display name.
  4. 4
    Done
    YiskiCal verifies the credentials and pulls your own Odoo meetings — the calendar.event records you are an attendee of, the same ones Odoo shows you in its own calendar. Colleagues' meetings are not pulled in, even if the account you connect is allowed to read them.
Your API key is used only to read calendar events over Odoo's JSON-RPC API. You can revoke it at any time from the same API Keys screen in Odoo.

⏰ Timeblocks

Timeblocks are events you create directly in YiskiCal — for planning focus time, reserving slots, or anything else. They exist only in this app and are never pushed to your connected calendars.

  1. 1
    Add a timeblock
    On the Calendar page, click + Add timeblock, or click a day first to pre-fill the date.
  2. 2
    Fill in the details
    Title, optional description, date, start/end time (or all-day), and a color.
  3. 3
    Manage them
    Upcoming timeblocks are listed in the sidebar, where you can delete them. They can also be shared with groups, just like a connected calendar.

👥 Groups & sharing

  1. 1
    Create or join a group
    On the Groups page you can create a group (public = anyone can discover and join it; private = joinable only with the invite code), join with an invite code a friend gave you, or browse public groups.
  2. 2
    Invite people
    Open the group and click the Invite code button to copy it, then send it to friends or colleagues.
  3. 3
    Choose what you share
    In the group's My shared calendars panel, tick which of your calendar connections (and/or your timeblocks) this group may see. Nothing is shared until you save — each group has its own independent selection.
  4. 4
    Pick the detail level
    Per shared calendar choose Details (members see titles, descriptions, locations) or Busy only (members only see anonymous "Busy" blocks — times, but no content). You always see your own full details.
  5. 5
    Or lock a calendar down everywhere
    If a calendar should never reveal its titles — a work calendar full of client names, say — set it to Private — busy only on the Connections page instead. That applies to every group you are in and every group you join later, and the per-group dropdown can no longer override it. The per-group setting above only decides for one group at a time, and a newly joined group starts at "Details".

🔗 Subscribe from another app

Every connected calendar can publish a private feed link (an ICS URL) that you can add to Google Calendar, Outlook, Apple Calendar or your phone. It is most useful for Odoo, which has no calendar feed of its own — this is how you get your Odoo meetings onto your phone.

  1. 1
    Create the link
    On the Connections page, click Feed next to a calendar, then Create feed link, then Copy.
  2. 2
    Add it to your calendar app
    Look for "Add calendar → From URL" (Google), "Subscribe from web" (Outlook) or "New calendar subscription" (Apple), and paste the link. The calendar appears read-only: nothing you do there is sent back to YiskiCal.
  3. 3
    Revoke it whenever you like
    Regenerate issues a new link and instantly breaks the old one for everybody using it; Turn off removes the feed altogether.
The link is the password. Calendar apps cannot log in, so anyone who has the URL can read that calendar's events — full titles and all, even for a calendar marked private for groups. Don't post it anywhere public, and regenerate it if it leaks.
Calendar apps decide for themselves how often they re-read a subscribed link. Google is often only every few hours, so a change in Odoo can take a while to show up there. Apple and Outlook are usually quicker.

🔧 Troubleshooting

My events aren't up to date
Calendars refresh automatically in the background, and how often depends on your plan: once a day on Free, every hour on Pro, and every 15 minutes for any calendar shared into a Team group (even if you are on Free — the group's plan wins). If you can't wait, Sync now on the Connections page refreshes a calendar immediately — that button is limited to 2 manual refreshes per calendar per day (resetting at midnight UTC, a limit we're currently trialling), and the button shows how many you have left. Events are cached from 30 days in the past to 12 months ahead — anything outside that window will not appear, however often you sync.
Why can I only press “Sync now” twice a day?
Every manual refresh sends a fresh round of requests to Google, Microsoft or your Odoo server, so the button is capped at 2 per calendar per day to keep it from being used as a substitute for the automatic schedule. It counts per calendar, not per account, and resets at midnight UTC — the button itself shows how many you have left.

Hitting the limit does not mean your calendar stops updating: it keeps refreshing on its own on your plan's schedule regardless. If you find yourself running out, that is usually a sign the automatic schedule is too slow for how you work — a faster one is what the Pro and Team plans buy.

This limit is being trialled and the number may change as we learn how people actually use it. If two a day is getting in your way, please tell us — that is exactly the feedback we want.
A connection shows an error
The error message is shown under the connection on the Connections page. Common causes: a revoked Google/Microsoft authorization (reconnect the account), or a revoked/expired Odoo API key (create a new key and reconnect). Disconnecting and reconnecting fixes most issues.
Odoo says authentication failed
Double-check all four fields: the server URL (including https://), the exact database name, your login email, and the API key (not your password — Odoo API access requires an API key when 2FA is enabled, and keys are the recommended method regardless).
Will YiskiCal change anything in my calendars?
No. Sync is strictly one-way (pull). The app only requests read-only permissions and only performs read operations, so it cannot modify, create or delete events in Google, Outlook or Odoo.
Who can see my calendars?
Only you, unless you do one of two things. Sharing a calendar with a group lets that group's members see it — per group, per calendar, and a "Busy only" share never exposes titles or details. Publishing a feed link (see Subscribe from another app) makes that calendar readable, in full, by anyone who has the link — so treat the link itself as a secret.