What you need
- A Microsoft account with an Outlook calendar
- An ApexGenius account
- At work or school, your Microsoft 365 admin may need to approve ApexGenius first
How to connect Outlook Calendar
How to connect Outlook Calendar
Before you startTry a first question with your AI agentCheck that the answer matches what you see in Outlook Calendar.Add your AI agent · Official Outlook Calendar instructions
- An account with permission to use the Outlook Calendar resources you intend to connect.
1
Open Outlook Calendar in Connections
Choose Connect, or Add connection when offered. Give the connection a name if prompted. If Gateway setup pending appears, contact ApexGenius support before continuing.
2
Choose the account and review access
Sign in with your Microsoft work, school or personal account and review the access Microsoft lists: your calendars, and staying signed in. Microsoft describes the calendar access as full access because creating an event needs it; ApexGenius only reads events and creates new ones. No API key is pasted into ApexGenius. If Microsoft says an admin must approve, ask your Microsoft 365 admin.
3
Review the connected account and resources
Confirm the connected account on the connection page. Open Tools to review the reads and the create tool. Creating an event runs right away when enabled, and Microsoft invites every attendee.
4
Check the connection
Use Test connection or Check again and read the reported status. Add an AI agent from the AI agents page, choose Read only for the first test, and try the question below.
What Microsoft asks you to allow
ApexGenius asks for three permissions, all for the person who signs in:
Microsoft describes
Calendars.ReadWrite as full access to your calendars. It is the one permission Microsoft offers for creating an event, and it also covers changing and deleting them. ApexGenius only reads events and creates new ones. It has no operation that changes or deletes an event.
If Microsoft asks for admin approval
Some organizations let only an admin approve a new app. If Microsoft shows a message that you need admin approval, your sign-in stops there and nothing is connected. Ask your Microsoft 365 admin to approve ApexGenius for your organization, then choose Connect again. The table above is what your admin is approving.Tools and the Outlook Calendar skill
Open Skills on the connection to read MicrosoftOutlookCalendar, or read that MCP prompt in a compatible AI client withprompts/get. It covers the first safe read, how to see a day or a week, how to read one event, how to create one, and what the connector cannot do.
Three ApexGenius tools route the Outlook Calendar operations:
Your AI discovers the tools with
apex_search_tools. Reads use apex_call_read_tool; creating an event uses apex_call_write_tool. Writes run immediately. Blocked hides a tool from agents.
Reading the calendar
list_calendar_view answers “what is on my calendar” for a range of time. It needs a start and an end, and it lists each repeat of a repeating event. list_events lists events without a range and shows a repeating event once, as the series. get_event reads one event. Start and end times come back in UTC, so ask your AI to show them in your time zone.
Creating an event
create_event puts a new event on your own calendar. When the event has attendees, Microsoft emails each one an invitation right away. That cannot be turned off and it cannot be recalled. Ask your AI to show you the title, the time and every attendee before it creates anything. Leave attendees out to block time for yourself.
One account per connection
The connection reaches the calendar of the Microsoft account you signed in with. Shared or delegated calendars and other people’s calendars are not included. To use a different account, disconnect and connect again.What it cannot do
- It cannot change, cancel or delete an event.
- It cannot answer an invitation.
- It cannot read or add attachments.
- It cannot reach a shared or delegated calendar, or another person’s calendar.
- It does not read mail. Connect Microsoft Outlook for that.
Connector, tools, and skill
If any row fails, Outlook Calendar is partially ready. A saved sign-in by itself is not a fully ready connection.
Troubleshooting
- Microsoft says you need admin approval: ask your Microsoft 365 admin to approve ApexGenius, then connect again. See the section above.
- Unavailable to this account: check that you are signed in to the intended ApexGenius account and refresh Connections.
- Wrong account: disconnect, then connect again and pick the right Microsoft account on Microsoft’s page.
- Reconnect required: use the connection page to sign in to Microsoft again. This can follow a password change or a new sign-in rule at your organization.
- Reads fail after a good sign-in: check that the account you signed in with has an Outlook mailbox. The calendar lives in it.
- A calendar view returns an error: it needs both a start and an end date and time.
- Tool disabled: the owner has turned the tool off. Review tool access on the connection page.