Skip to content

Calendar and contactsCalendar

Calendar and CalDAV

Every Shipmail mailbox comes with a calendar. Open Calendar in the dashboard to plan your day, week, month, or upcoming agenda, then sync your mailbox calendars to your phone and laptop over CalDAV.

Last updated

Views

Switch between Day, Week, Month, and Agenda in the top bar. Week shows a time grid with a line at the current time. Day is the default on mobile. Agenda lists the next 14 days with event times and the mailbox each event belongs to. Pick the view Calendar opens with in Settings > Preferences > Calendar. The arrows move one day, week or month at a time, Today goes back to today, and the date control jumps to any date. Keyboard: t for today, arrow keys to navigate, and w,m, d to switch views.

Search your calendars in the side panel and choose which of your mailboxes show in the schedule. New events are saved to the organizer calendar. Hiding or showing calendars does not change the organizer. Mobile shows the current organizer too. An existing event stays in its own mailbox when you edit, move, or respond to it. If a calendar fails to load, a retry control appears, so you know the schedule is missing something.

In your mailbox calendars, cancelled events never show in any view, the same as in Google Calendar and Apple Calendar. You still get the cancellation email. Events you declined are hidden too. To see them, turn on Settings > Preferences > Calendar > Show declined events. They then show faded and marked Declined. The setting is yours alone and applies on the web. The mobile app always hides declined events. Cancelled and declined events never block your availability or your booking pages. Calendars you subscribe to follow their own settings, described below.

Creating events

Click an empty slot in the grid, or drag across a range, to open the event editor with the times filled in. It starts small. Add a title and save, or click Add guests, Add video meeting, Add location, Add description, or Add reminder to open only those sections. Type an address, a town, or a business name in Location to pick a place suggested by Google Maps. You can also type any location, such as Online or Room 4. Time fields accept typed times like 9, 2pm, or 14:30, and also open a list of half-hour slots. End times show the event duration. Drag an event to move it, or drag its edges to change the start and end time. Deleting an event shows an Undo toast.

New events use your browser time zone. To use a fixed zone instead, pick one under Settings > Preferences, under Calendar. Times then stay put when you travel or change your computer's clock. The slot you click stays the same moment, and only the event's zone changes. The editor still lets you change the zone per event. The same settings section switches the calendar between 12-hour and 24-hour time.

Before saving, check the organizer address and guest count, and choose whether to send invitations or guest updates. If a save fails, the editor keeps your draft. If Shipmail can't tell whether a save went through, it checks before creating another event. If the event saved but the invitations did not all go out, use Retry invitations to finish sending them. An invitation with an unknown result stays pending until Shipmail can confirm it.

End must be after start. For an overnight event, choose the following end date. All-day events use calendar dates rather than clock times. Finish each guest address or remove the unfinished entry before saving.

A temporary onboarding inbox can invite only your signup address and Shipmail support. The guest section shows the allowed addresses before you save. Connect your domain to invite anyone else.

Recurrence

In the event editor, set an event to repeat daily, weekly, monthly, or yearly, or build a custom rule (for example, every second Tuesday). Recurring events show on every date they fall on and stay in sync across your devices. Editing a recurring event changes the whole selected event, that event and every event after it, or the whole series.

Calendar colors

Each calendar has a color. To change it, open the menu beside the calendar in the side panel and pick a color. A color you pick is shared with everyone who can see that mailbox, and Apple Calendar, other CalDAV apps and the Shipmail app show it too. Automatic gives the calendar a color from its place in your list, shown in Shipmail only.

An event without a color of its own takes its calendar's color, so changing the calendar's color recolors those events. In the event editor, the first swatch keeps that link; the others give the event a color of its own.

Import from Google Calendar

Move your existing calendar over with a one-time export. Recurring events stay recurring. Shipmail adds the imported events to the mailbox calendar you pick. If an event with the same calendar ID is already there, Shipmail skips it. It never replaces it or creates a duplicate.

Export from Google

  1. Go to takeout.google.com and choose Deselect all.
  2. Select only Calendar, then choose Next step.
  3. Keep the defaults (export once, .zip) and choose Create export. Google emails you a download link when it is ready.
  4. Download and unzip the archive. Inside the Takeout/Calendar folder is one .ics file per calendar.

Upload to Shipmail

  1. Open Calendar in the dashboard and choose Import in the top bar.
  2. Drag in the .ics file, or choose it from your computer. Files up to 10 MB are supported.
  3. Choose Import. Your events appear on the grid right away, and the summary reports how many were imported, skipped, or could not be imported.

Cancel or undo an import

Open Import again to see the most recent import. You can cancel one that is still running. Events it already added stay on the calendar until you choose Undo import. Undo removes only the events that import created, and leaves events that were already there alone. You can close the page while a cancel or undo finishes in the background.

The same steps work for any calendar that can export an .ics file, including Apple Calendar and Outlook.

Sync to your devices

The calendar is a CalDAV calendar, so it works with the calendar apps you already use. Changes sync both ways. Use these settings, or open Sync in the calendar top bar to copy the settings for each mailbox.

Google Calendar can't connect to a CalDAV calendar. To see Shipmail events in Google Calendar, subscribe to a read-only link, as described in Share a read-only calendar below.

CalDAV URLhttps://mx1.shipmail.to/dav/cal/you@yourdomain.com/
Servermx1.shipmail.to
UsernameYour full email address
PasswordYour mailbox password

iPhone or iPad

  1. Open Settings, then Calendar, then Accounts, then Add Account, then Other, then Add CalDAV Account.
  2. Server: mx1.shipmail.to. User Name: your full email address. Password: your mailbox password.
  3. Choose Next, then Save.

Mac (Calendar app)

  1. Open System Settings, then Internet Accounts, then Add Other Account.
  2. Choose CalDAV Account, then set Account Type to Manual.
  3. Server Address: mx1.shipmail.to. User Name: your full email address. Password: your mailbox password.

Thunderbird

  1. Open New Calendar, then On the Network.
  2. Paste the CalDAV URL above as the Location and enter your full email address as the username.
  3. Sign in with your mailbox password when prompted.

Other clients

Android with DAVx5, GNOME Calendar, and Evolution all work. Add a CalDAV account with the URL above. Most clients can also find the calendar through /.well-known/caldav. If a client asks for a base URL instead of a full path, enter https://mx1.shipmail.to.

Subscribe to other calendars

You can subscribe to a calendar outside Shipmail, such as your personal Google Calendar, with its secret iCal address. Choose Subscribe to a calendar from the Calendar side panel's menu, or add it under Settings > Preferences > Other calendars. You can subscribe to up to 10. For Google Calendar:

  1. In Google Calendar on the web, open Settings and choose the calendar under Settings for my calendars.
  2. In Integrate calendar, copy Secret address in iCal format.
  3. In Shipmail, choose Subscribe to a calendar, give it a name, paste the address, and pick its two settings.

Other apps work the same way when they give a private iCal address. In iCloud, share the calendar as a public calendar and copy its link. In Outlook on the web, publish the calendar with permission to see when you are busy, and copy its ICS link. A link that starts with webcal:// works too. Shipmail only reads the calendar: nothing you do in Shipmail changes it.

Each calendar has two settings, which you can change later from its menu in Settings:

  • Block my time, on by default. Its busy events are not offered on your booking pages, and Find time and teammates see you as busy. Turn it off for a calendar you only want to see, such as a team's holidays.
  • Show event titles, off by default. Shipmail keeps each event's title and times and shows them in your calendar. Only you see them.

By default the other calendar decides each event: events it marks free, and invitations you declined, never block time, and cancelled events do not show. An all-day event blocks the whole day in the booking page's time zone. A calendar starts blocking times after its first successful read.

Choose for one event

You can decide for a single event, or a single occurrence of a recurring event, whether it takes your time. Click it in Calendar (or tap it in the Shipmail app) and pick one of three options: Default, which follows the calendar's Block my time setting and what the other calendar says, Blocks my time, or Does not block. For example, subscribe to a team calendar with Block my time off, and make only the meetings you attend block your booking pages, without copying them. Your choice applies even to an event the other calendar marks free or that you declined. Choosing Default again removes it. You can make up to 200 choices per calendar.

A choice follows the event as long as the other calendar keeps the event's identifier. An event without a stable identifier follows the calendar's setting and cannot be chosen, and an event that takes no time, such as a reminder, never blocks. When a read no longer contains an event you chose for, for example because the other app recreated it, Shipmail keeps your choice and lists it under the calendar's Settings, so you can choose again on the event or remove it. A choice is deleted at the first read two days after its time has passed, or at the first successful read after 30 days in which no successful read contained the event. A choice stays when you change the calendar's Block my time setting, even while it says the same as the new default.

What Shipmail keeps

Shipmail reads a calendar every five minutes when it blocks your time or one of its events is chosen to block, and every 30 minutes otherwise. For every calendar it keeps when each event starts and ends, free events included, from one day back to a year ahead, so you can see and choose them, with a hashed identifier for each event instead of the identifier the other calendar uses. With titles on, it also keeps each title, cut to 200 characters, and 30 days of past events; older ones are deleted, even while the calendar fails to update. It never keeps an event's location, guests, or description. If a read fails, Shipmail keeps the last good copy, and Settings shows the error and when the calendar last updated.

In Calendar, each event shows read-only in the Day, Week, Month and Agenda views, with its title when titles are on, or as Busy or Free when they are off. An event that does not take your time has an outline and no fill. Each calendar has its own row under Other calendars in the side panel, where you can hide it. When its last update failed, the row says when it last updated and links to Settings. The Shipmail app shows the same events in its Day and Week views. A teammate or an admin who opens your mailbox sees none of them. To check what a booking page offers, open the page itself or choose View live availability in its editor.

Find time and a teammate's availability in the event editor also count the events that take your time, for the mailbox you own: every mailbox when you are the only person in your organization, otherwise the mailbox whose address is your sign-in email. Teammates see only that the time is busy, never the calendar's name or an event's title. A shared mailbox has no owner, so Find time counts no other calendar for it, even when a booking page on that mailbox names you as its host and refuses times your other calendars mark busy.

Turning titles off deletes the stored titles at once. Removing a calendar deletes everything Shipmail kept from it, your choices included, and when you leave an organization, the calendars you subscribed to there are deleted.

The address works like a password: anyone who has it can read the calendar. Shipmail stores it encrypted and shows only its host after you save it. If it leaks, remove the calendar in Shipmail and reset the secret address in the other app.

Share a read-only calendar

An Owner or Admin can let someone subscribe to a mailbox calendar without giving them a Shipmail login or the mailbox password.

  1. Open Calendar and choose Share calendar from the top-bar menu.
  2. Create the subscription link and copy it.
  3. In the other calendar app, paste it into Subscribe by URL or Add calendar by URL.

The link works with Apple Calendar, Google Calendar, Outlook, Nextcloud, and other apps that accept iCalendar subscriptions.

Choose Titles and times to share event names, or Free/busy only to hide every name. Private events always appear as Busy. Descriptions, guests, locations, and meeting links are never included. Anyone with the link can subscribe. If it reaches the wrong person, create a new link, or choose Stop sharing to turn it off at once. Each calendar app decides how often it refreshes a subscription, so changes can take a while to show.

Invites and guests

In the event editor, add guests by email. Suggestions include saved contacts, recent recipients, and the mailboxes and aliases on your account and team. Each guest gets an email invite and can RSVP, and their status (accepted, tentative, declined, or awaiting response) shows on the event. When a guest is a teammate in your organization, the editor shows their availability from the calendars you can access. Shipmail does not check external guests or calendars it can't reach.

Find time searches the Shipmail calendars you selected. Set working days, start and end times, the search range, and time zone. These are your personal defaults, separate from your public booking-page settings. The dialog shows which calendars it checked and which guests have unknown availability. A suggested time ignores any calendar left out of the search.

Open event details to see guest responses, the recurrence rule, and the full date span. Invited attendees can accept, respond tentatively, or decline from the calendar, the same way as from the inbox. If the event has a meeting link, open it from event details. Shipmail also finds a Teams, Zoom, Google Meet or Webex link in the description or location of an invite, so an Outlook or Teams invite gets a Join button too. Its dial-in numbers, meeting ID and passcode move under Joining info. Links in the description open in a new tab, and a long description shows four lines until you click Show more.

After adding a guest, choose English, French, or Spanish under Language. Shipmail uses that language for invitation, update, and cancellation emails, plus the RSVP page when the guest's browser does not provide a supported language. The event title, description, and location stay exactly as you wrote them. Changing only the language saves the new choice without sending another invitation.

When you move or resize an event with guests, Shipmail asks whether to send update emails. You can add one message for everyone, send the update, continue without sending, or cancel the move. A sent reschedule keeps the same event and video meeting link, and resets guest responses so each person can confirm the new time.

Events suggested from email

When someone proposes a concrete time in a plain email, like "can we call tomorrow at 3pm?", the message shows a suggested event card above its body in the inbox. The card shows the detected title, the date and time, and the sentence it came from. Add to calendar opens the normal event editor with the time filled in and the sender as a guest, so you can review everything before saving. Dismiss hides the suggestion for that message.

Suggestions appear on paid plans for personal mail with a single clear time. Newsletters, notifications, and messages that already carry a calendar invite never produce one. Every message also keeps the manual add-to-calendar button in its toolbar.

Detection uses an open-source AI model that Shipmail runs on its own server in Germany. No outside AI provider receives your mail. It is on by default. Organization admins can turn AI features off in Settings, General, Data, which also stops suggestions.

When an email states a duration, Shipmail uses it. Otherwise, the suggested event uses your personal default in the Calendar section of Settings > Preferences. You can choose 15, 30, 45, 60, 90, or 120 minutes. Teammates can choose different defaults for the same shared mailbox.

Plan with the AI assistant

In the web app, ask the AI assistant to find a meeting time across the calendars you can access, update or cancel an event you organize, or prepare an invitation. Before you confirm, it shows the event details and everyone who will receive an email.