Docs
Guide to Younical’s MCP server
Younical’s MCP server connects your Younical account to AI assistants like Claude, Grok and Cursor. Check your schedule, find free time, and create or update events in plain language, without leaving the chat.
Before you start
- A Younical account. Sign up at https://younical.io
- At least one Google or Microsoft calendar connected in Younical.
- An AI app that supports remote MCP connectors.
How to connect
- In your AI app, add a custom connector with this URL: https://mcp.younical.io
- When asked, sign in with your Younical account.
- Review the permissions and click Allow.
To disconnect, remove the connector in your AI app.
What you can do
| Tool | What it does |
|---|---|
list_calendars |
Shows the calendars connected to your Younical account |
list_events |
Lists events on a calendar (up to 31 days at a time) |
find_free_time |
Finds free slots in your own calendar |
check_availability |
Finds shared free times with other people |
search_people |
Finds people by name or email before booking |
create_event |
Creates an event on your calendar, with no guests |
book_meeting |
Creates a meeting and invites guests |
update_event |
Changes an event's time, title, guests or video link |
delete_event |
Deletes an event or a repeating series |
set_default_calendar |
Saves which calendar hosts new meetings |
list_syncs |
Shows your calendar syncs (read-only) |
Example prompts
- What's on my Younical calendar this week?
- Find a free 30-minute slot tomorrow afternoon.
- Create an event called Planning on Friday at 10am.
- Book a meeting with Ana next Tuesday at 3pm.
Safety
- Inviting guests, deleting repeating events, and changing a whole series always show a preview first. Nothing happens until you confirm.
- Invites send real emails to guests.
- You only access your own calendars. Sign-in uses secure OAuth, and Younical never sees your AI app password.
Privacy
Younical reads and changes only the calendars you connected, and only when you ask. See our privacy policy: https://younical.io/privacy-policy
Support
Questions or problems? Email help@younical.io