Skip to content

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

  1. 1Sign in to ApexGenius and connect Microsoft Outlook
  2. 2Add the ApexGenius MCP server to Hermes Agent
  3. 3Start using Microsoft Outlook in Hermes Agent
  1. 1ApexGenius

    Connect ApexGenius to Hermes Agent

    Copy the MCP address

    On Start, pick API key, open Manual setup, and copy the MCP address.

  2. 2ApexGenius

     

    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.

  1. Add the apexgenius entry under mcp_servers and save the file.
  2. In a new terminal, run hermes mcp login apexgenius. Hermes prints an authorize URL and opens your browser when it can.
  3. Sign in to ApexGenius and approve access.
  4. Start Hermes with hermes chat, or run /reload-mcp in a session that is already open.
Add to ~/.hermes/config.yaml
mcp_servers:
  apexgenius:
    url: "https://server.autom8.pro/mcp"
    auth: oauth

Check 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.

Start free
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

  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.
Connect Microsoft Outlook →

2. Connect ApexGenius to Hermes Agent

Use this server address when adding the connection:

https://server.autom8.pro/mcp

The 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.yaml inside a running session reloads MCP with a 30 second limit, too short for a browser sign-in. hermes mcp login waits five minutes.
  • Where the sign-in is kept. Hermes caches the tokens at ~/.hermes/mcp-tokens/apexgenius.json and reuses them until a refresh fails. Run hermes mcp login apexgenius again 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

Example workflow
Hermes Agent
Hermes AgentApexGenius MCP route
Show the subjects and senders of my five most recent Outlook messages. Do not send anything.
ApexGenius
Working with ApexGenius1 tool search · 2 reads
RequestRecent mail
Account scopeAuthorized connections checked
apex_search_toolsOutlook messages · Find the Outlook read routeComplete
apex_call_read_toolget_me · Check the connected mailboxComplete
apex_call_read_toollist_messages · List recent messagesComplete
Hermes Agent

Five messages from today, two from clients and three newsletters. Nothing was sent.

Read-only route
Hermes Agent

What 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), then list_messages (read).

  • Unread today

    What unread mail did I get today, and who is it from? Do not send anything.

    Runs get_me (read), then list_folder_messages (read), then get_message (read).

  • Folder check

    List my Outlook mail folders with their unread counts. Do not send anything.

    Runs get_me (read), then list_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 read
  • get_meread

Messages

2 read
  • list_messagesread
  • get_messageread

Mail folders

2 read
  • list_mail_foldersread
  • list_folder_messagesread

Send

1 write
  • send_mailwrite

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.

Start free

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.

Connect Microsoft Outlook to Hermes Agent today

Start free

1,000 free credits. No card required. Disconnect any time.