Getting Started
Use this walkthrough to go from a new account to your first confirmed calendar change. The fastest path is dashboard first: sign in, connect a calendar, then use web chat, Telegram, WhatsApp, booking links, group invites, or an AI agent through MCP.
Sign in
Open the Calendaria dashboard, enter your email, and use the magic link to create a browser session without a password.
Connect a calendar
Choose Google Calendar or Microsoft Outlook and approve access so Calendaria can read and write events.
Open web chat
After Google is connected and your trial or subscription is active, use Open chat from the dashboard.
Link chat
Link Telegram or WhatsApp when you want Calendaria available from a mobile chat app too.
Create booking links
Share a public link when you want someone else to pick from your computed free slots.
Invite groups
Share a fixed-event RSVP link when you want to count who is in.
Connect MCP
Add the Calendaria MCP URL to Claude, Cursor, or another OAuth-capable MCP client.
1. Sign in with your email
Open the Calendaria app and enter your email address. Calendaria sends a magic link so you can sign in without creating a password.
You reach the dashboard
The account card shows the email you used to sign in. That identity is separate from connected calendar accounts, web chat, Telegram, and WhatsApp linking.
2. Connect a calendar
From the dashboard, connect Google Calendar or Microsoft Outlook. The provider asks for permission to read and write calendar events.
Calendaria supports multiple connected calendar accounts per Calendaria user. Connect another account when you want Calendaria to read across more calendars or use a different account for new events.
Calendar providers
Google Calendar and Microsoft Outlook are supported today. Apple Calendar, CalDAV, and broader provider federation remain roadmap items.
3. Open web chat
After a calendar is connected and Calendaria Personal is trialing or active, the dashboard shows Open chat. Use it when you want the assistant directly in the browser. You can type a request, record audio, or upload an audio file.
What to look for
- 1Greeting The chat opens as an assistant surface inside the dashboard.
- 2Natural language You can ask the same calendar questions you would send in any connected chat channel.
- 3Same safety model Writes still require confirmation before Calendaria changes a calendar.
4. Link a chat channel
Use Telegram or WhatsApp when you want Calendaria in the chat app you already use during the day. After linking, you can type requests or send supported voice/audio messages.
For Telegram, use @AICalendarBot. If you start from the bot, Calendaria gives you a private setup link that opens the dashboard. If you start from the dashboard, follow the Telegram linking step shown there.
For WhatsApp, start from the Calendaria WhatsApp chat. If that WhatsApp identity is not linked yet, Calendaria can send a private sign-in link. After you sign in, the dashboard links that WhatsApp chat identity to the same Calendaria user.
Useful Telegram setup commands:
| Command | Use it when |
|---|---|
/start |
You need to sign in, sign up, or link this Telegram chat to your Calendaria account. |
/help |
You want the current command list and natural-language examples. |
/whoami |
You want to check which account this chat is linked to, including timezone and calendar connection status. |
Expected result
After Telegram or WhatsApp is linked, everyday calendar commands continue in that chat.
5. Send your first read command
In web chat, Telegram, WhatsApp, or a connected MCP client, try:
what do I have tomorrow?
or:
que tengo manana?
Read commands execute immediately because they do not change your calendar.
On web chat, Telegram, and WhatsApp, the same first request can also start as audio. Calendaria transcribes the audio and then handles the transcript like typed text.
6. Create an event
Try:
block 4-8pm tomorrow for the deck
Calendaria parses the request and returns a summary with confirmation controls. The event is created only after you confirm.
7. Move or delete an event
You can also ask:
move my 3pm to 4
delete the design review
Calendaria may first list matching events if your wording is ambiguous. Any final write still requires confirmation.
8. Create a booking link
Use booking links when you want another person to pick a time without seeing your calendar details.
create a booking link for 30-minute intro calls
The link opens a public booking page with computed free slots. You can copy or revoke active links from the dashboard. See Booking links for the full flow.
9. Create a group invite
Use group invites when the event time is fixed and you want to count who joins.
I'm hosting dinner Saturday at 8pm, create an invite link for 8 people
Calendaria creates the event after confirmation and gives you a public RSVP link. See Group invites for the full flow.
10. Connect an AI agent with MCP
Use Calendaria's remote MCP URL when you want an AI agent in Claude, Cursor, or another OAuth-capable MCP client to use Calendaria calendar tools:
https://api.calendaria.co/mcp
The client opens Calendaria's authorization page, you sign in with a magic link, and you authorize the agent. Read-only tools can inspect calendar data immediately. Calendar-changing tools create pending actions and require confirmation before Calendaria changes a calendar.
For ChatGPT, Calendaria is creating a dedicated Calendaria ChatGPT app. Use that app flow when it is available.