What you need
- A Microsoft account with an Outlook mailbox
- An ApexGenius account
- At work or school, your Microsoft 365 admin may need to approve ApexGenius first
How to connect Microsoft Outlook
How to connect Microsoft Outlook
Before you startTry a first question with your AI agentCheck that the answer matches what you see in Microsoft Outlook.Add your AI agent · Official Microsoft Outlook instructions
- An account with permission to use the Microsoft Outlook resources you intend to connect.
1
Open Microsoft Outlook 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: read your mail, send mail as you, and stay signed in. 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 mailbox on the connection page. Open Tools to review the reads and the send tool. Sending runs right away when enabled and cannot be recalled.
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 four permissions, all for the person who signs in: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 skill
Open Skills on the connection to read MicrosoftOutlook, or read that MCP prompt in a compatible AI client withprompts/get. It covers the first safe read, how to find and read mail, how to send, and what the connector cannot do.
Three ApexGenius tools route the Outlook operations:
The reads cover the signed-in account, the messages in your mailbox, one message as plain text, your mail folders with their unread counts, and the messages in one folder.
Your AI discovers the tools with
apex_search_tools. Reads use apex_call_read_tool; sending uses apex_call_write_tool. Writes run immediately. Blocked hides a tool from agents.
One mailbox per connection
The connection reads and sends from the mailbox of the Microsoft account you signed in with. Shared mailboxes and other people’s mail are not included. To use a different account, disconnect and connect again.What it cannot do
- It cannot reply, forward or save a draft.
send_mailsends a new message. - It cannot read or send attachments.
- It cannot move, flag or delete mail.
- It cannot reach a shared mailbox.
- It does not read your calendar. Connect Outlook Calendar for that.
Connector, tools, and skill
If any row fails, Outlook 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 mailbox: 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.
- Tool disabled: the owner has turned the tool off. Review tool access on the connection page.