Connect Hermes Agent to Microsoft Outlook
Connect Hermes Agent to Microsoft Outlook: 1. Connect Microsoft Outlook in ApexGenius. 2. Add the ApexGenius MCP server. 3. Ask Hermes Agent.
1,000 free credits · No card required
How to connect Microsoft Outlook to Hermes Agent
- 1Sign in to ApexGenius and connect Microsoft Outlook
- 2Add the ApexGenius MCP server to Hermes Agent
- 3Start using Microsoft Outlook in Hermes Agent
- 1
Connect ApexGenius to Hermes Agent
Copy the MCP address
On Start, pick API key, open Manual setup, and copy the MCP address.
- 2
Approve access
ApexGenius opens its approval page. Review the access, then approve.
Add the ApexGenius MCP server to Hermes Agent
Hermes Agent reads MCP servers from ~/.hermes/config.yaml, under mcp_servers.
- Add the apexgenius entry under
mcp_serversand save the file. - In a new terminal, run
hermes mcp login apexgenius. Hermes prints an authorize URL and opens your browser when it can. - Sign in to ApexGenius and approve access.
- Start Hermes with
hermes chat, or run/reload-mcpin a session that is already open.
mcp_servers:
apexgenius:
url: "https://server.autom8.pro/mcp"
auth: oauthCheck it. Run hermes mcp test apexgenius. It connects, lists the tools it found and exits 0 when the connection completes.
Steps follow Hermes Agent documentation, MCP (Model Context Protocol) (opens in a new tab), read November 12, 2026.
Then ask Hermes Agent
Show the subjects and senders of my five most recent Outlook messages. Do not send anything.
Written setup, step by stepShow
Before you start
- An account with permission to use the Microsoft Outlook resources you intend to connect.
1. Connect Microsoft Outlook to ApexGenius
- 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.
- 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.
- 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.
- 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.
2. Connect ApexGenius to Hermes Agent
Use this server address when adding the connection:
https://server.autom8.pro/mcpThe steps are above, under Add the ApexGenius MCP server to Hermes Agent. These notes apply to Hermes Agent only.
- On a server with no browser. Hermes prints “Or paste the redirect URL here” beside the authorize URL. Open the URL on your own machine, approve, and paste the full URL the browser lands on. That page shows a connection error, which is expected.
- Use a new terminal for the sign-in. Editing
config.yamlinside a running session reloads MCP with a 30 second limit, too short for a browser sign-in.hermes mcp loginwaits five minutes. - Where the sign-in is kept. Hermes caches the tokens at
~/.hermes/mcp-tokens/apexgenius.jsonand reuses them until a refresh fails. Runhermes mcp login apexgeniusagain if that happens. - Tool names. Hermes prefixes each MCP tool with the server name, so the ApexGenius tools carry apexgenius in their names.
- Access. When ApexGenius asks what Hermes Agent may use, choose Read only for the first test, or Custom to limit it to the tools you need.
3. Try your first question
Show the subjects and senders of my five most recent Outlook messages. Do not send anything.
Show the subjects and senders of my five most recent Outlook messages. Do not send anything.Check that the answer matches what you see in Microsoft Outlook.
Full guide: the Microsoft Outlook setup guide.
What it looks like in Hermes Agent
apex_search_toolsOutlook messages · Find the Outlook read routeCompleteapex_call_read_toolget_me · Check the connected mailboxCompleteapex_call_read_toollist_messages · List recent messagesCompleteFive messages from today, two from clients and three newsletters. Nothing was sent.
Read-only routeWhat to ask Hermes Agent about Microsoft Outlook
- Recent mail
Show the subjects and senders of my five most recent Outlook messages. Do not send anything.
Runs
get_me(read), thenlist_messages(read). - Unread today
What unread mail did I get today, and who is it from? Do not send anything.
Runs
get_me(read), thenlist_folder_messages(read), thenget_message(read). - Folder check
List my Outlook mail folders with their unread counts. Do not send anything.
Runs
get_me(read), thenlist_mail_folders(read).
These 3 questions use 5 of Microsoft Outlook’s 6 operations. The full list is below.
- Find the latest Outlook message that mentions an invoice and tell me the amount and due date. Do not send anything. (read)
- Send a new email from my Outlook mailbox to the address I give you. Show me the recipients, subject and text first, and send only after I say yes. (write)
What Hermes Agent can do in Microsoft Outlook
6 operations: 5 read, 1 write. Read looks things up and changes nothing. Writes change Microsoft Outlook and run only when you turn them on.
Mailbox
1 readget_mereadRead the signed-in Microsoft account: its name and mail address.
Messages
2 readlist_messagesreadList messages across the mailbox. Filter, search and sort them, newest first if asked.
get_messagereadRead one message. The body comes back as plain text.
Mail folders
2 readlist_mail_foldersreadList mail folders with their unread counts.
list_folder_messagesreadList the messages in one folder, such as the inbox or sent items.
Send
1 writesend_mailwriteSend a new message as you, with a subject, text and recipients. It cannot be recalled.
You choose the access. When you approve Hermes Agent, pick Full access, Read only, or Custom.
One connection is one Microsoft mailbox: the one you signed in to. Shared mailboxes and other people's mail are not included.
Mail only. There is no operation for drafts, replies, forwarding, attachments, or moving or deleting mail. Calendar is a separate connector, Outlook Calendar.
The read route runs only reads. Sending uses the write route.
Writes run immediately. Blocked hides a tool from agents.
A sent message cannot be recalled. Microsoft confirms it accepted the message, which is not proof of delivery.
Questions about connecting Hermes Agent to Microsoft Outlook
Updated November 16, 2026.
How do I connect Hermes Agent to Outlook?
Connect Hermes Agent to Outlook through ApexGenius in three steps. Sign in to ApexGenius and connect Microsoft Outlook by signing in with the Microsoft account that owns your mailbox. In Hermes Agent, add an apexgenius entry with the ApexGenius MCP address and auth: oauth under mcp_servers in ~/.hermes/config.yaml, then run hermes mcp login apexgenius. Then open a task in Hermes Agent and ask a question about your mail. Start with a read, so nothing is sent.
How do I check that Hermes Agent can use Microsoft Outlook?
Run hermes mcp test apexgenius. It connects, lists the tools it found and exits 0 when the connection completes. In a session that is already open, /reload-mcp picks up a config change. If the sign-in has expired, run hermes mcp login apexgenius again. Then ask: “Show the subjects and senders of my five most recent Outlook messages. Do not send anything.”
Is there an Outlook MCP server for Hermes Agent?
Yes. ApexGenius is an MCP server that Hermes Agent connects to once. It carries your Outlook connection and 6 Outlook operations, so Hermes Agent does not need a separate Outlook integration or plugin. You set it up one time and add each agent the same way.
What can Hermes Agent do in Outlook once it is connected?
Hermes Agent can run 6 Outlook operations through ApexGenius: 5 reads that check the signed-in account, list and read messages, and list mail folders and the messages in one folder, plus a send operation that sends a new message as you.
Can Hermes Agent read my Outlook inbox?
Yes, the one mailbox you connect. The connection reads only the mailbox of the Microsoft account you signed in with, and message bodies come back as plain text. Choose Read only and Hermes Agent can list and read mail and folders, and nothing else.
Can Hermes Agent send email from my Outlook?
Not until you allow writes. Choose Read only and it cannot send. With writes on, Hermes Agent can send a new message as you, and a sent message cannot be recalled. It cannot reply, forward, save drafts, add attachments or delete mail. Block the send tool to stop sending.
Can I use the same Outlook connection with Claude, ChatGPT, Grok Bot or Muse?
Yes. One Outlook connection in ApexGenius works with every compatible agent you add, including Claude, ChatGPT, Grok Bot or Muse. Each agent gets its own access choice and its own short setup, so you can pick read only for one agent and more for another.
More connections like this one
Hermes Agent with other apps
All 50 apps Hermes Agent can use
Google Docs
Google Drive
Google Slides
Atlassian Rovo
Polymarket
OP.GGConfluence
Supabase
Cal.com
ChatGPT Ads
GitHub
Stripe
Attio
Semrush
Apify
Linear
Jira
HQ Rental
Google Ads
Google Analytics
Google Forms
Google Tasks
Google Calendar
Google Sheets
Apollo
Blotato
Bing Webmaster
Calendly
ClickUp
monday.com
YouTube
YouTube Analytics
Salesforce
n8n
Google Search ConsoleElevenLabs
FreshBooks
Trello
GitLab
TypeSafeHubSpot
Outlook Calendar
Connect Microsoft Outlook to Hermes Agent today
Start free1,000 free credits. No card required. Disconnect any time.