Skip to content

Connect Codex to Microsoft Outlook

Connect Codex to Microsoft Outlook: 1. Connect Microsoft Outlook in ApexGenius. 2. Add the ApexGenius plugin. 3. Start using Microsoft Outlook in Codex. Start in Plugins in the ChatGPT desktop app and authorize your connection.

1,000 free credits · No card required

How to connect Microsoft Outlook to Codex

  1. 1Sign in to ApexGenius and connect Microsoft Outlook
  2. 2Add the ApexGenius plugin to Codex
  3. 3Start using Microsoft Outlook in Codex
  1. 1ApexGenius

    Connect ApexGenius to Codex

    Choose Codex

    Back on Start, pick Codex and copy the prompt.

  2. 2ApexGenius

     

    Approve access

    ApexGenius opens its approval page. Review the access, then approve.

Add the ApexGenius plugin to Codex

Codex stores MCP servers in ~/.codex/config.toml. The ChatGPT desktop app, the Codex CLI and the IDE extension share that file, so one setup covers all three on the same machine.

  1. In the ChatGPT desktop app, open Plugins and select an ApexGenius plugin shared with you or one you created. Connect it and authorize the app connections you intend to use.
  2. No plugin? Open Settings, then MCP servers, then Add server. Name it ApexGenius, choose Streamable HTTP and paste the MCP address.
  3. Save, select Restart, then Authenticate, and sign in to ApexGenius in your browser.
  4. Start a new Codex task.

The MCP address

https://server.autom8.pro/mcp

Check it. In the composer, type /mcp to view the connected servers.

Steps follow OpenAI documentation, Model Context Protocol for ChatGPT and Codex (opens in a new tab), read November 12, 2026.

Then ask Codex

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 Codex

The steps are above, under Add the ApexGenius plugin to Codex. These notes apply to Codex only.

  • From the terminal. The commands are under Manual setup for developers. codex mcp list shows the configured servers, and codex mcp login apexgenius runs the sign-in.
  • Without a local browser. Run codex mcp login apexgenius --no-browser, open the printed authorization URL on another machine, sign in, and paste the full redirect URL back into the terminal.
  • Asking before writes. In config.toml, default_tools_approval_mode = "writes" on the apexgenius server makes Codex ask before any tool that is not marked read-only.
  • ChatGPT on the web. ChatGPT on the web does not read local Codex configuration. It uses plugins.
  • Access. When ApexGenius asks what Codex may use, choose Read only for the first test, or Custom to limit it to the tools you need.

Watch the setup

Follow each step at your own pace.

Codex desktop app with Plugins selected and ApexGenius listed under Available to your account.
Open Codex in the ChatGPT desktop app, then Plugins, and find ApexGenius.Open full-size image (opens in a new tab)

After connecting, open Codex in the desktop app and start a new task with ApexGenius enabled.

Use a plugin shared with you or one you created, subject to your account and workspace policy.

Create a personal plugin

Where Developer mode is available, open ChatGPT Settings, then Security and login, and enable it. In Plugins, select the plus button, enter ApexGenius and a description, then add this URL under Connection. Create the connection, complete OAuth, and review the tools. Return to Codex in the desktop app and start a new task with the plugin enabled.

https://server.autom8.pro/mcp
OpenAI custom connection guide (opens in a new tab)
No plugin available? Use desktop settings
  1. In the ChatGPT desktop app, open Settings, then MCP servers, then Add server.
  2. Name the server ApexGenius, choose Streamable HTTP, and paste the MCP address below.
  3. Save, select Restart, then Authenticate. Sign in to ApexGenius and authorize the intended connections and access.
  4. Start a new Codex task and ask one read-only question. Check the returned result and its matching successful read in Activity.
https://server.autom8.pro/mcp
OpenAI desktop MCP settings (opens in a new tab)
Manual setup for developers

Codex CLI is optional. Run these commands, complete browser authorization, then start a new session. Do not paste bearer tokens or static authorization headers.

Register the remote MCP server

codex mcp add apexgenius --url https://server.autom8.pro/mcp

Authorize in your browser

codex mcp login apexgenius

Inspect registered servers

codex mcp list

The desktop app, CLI, and IDE extension share MCP configuration on the same host. The IDE extension does not install plugins. ChatGPT web does not read local Codex configuration.

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 Codex

Example workflow
Codex
CodexApexGenius 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
Codex

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

Read-only route
Codex

What to ask Codex 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 Codex 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 Codex, 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 Codex to Microsoft Outlook

Updated November 16, 2026.

How do I connect Codex to Outlook?

Connect Codex 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 the ChatGPT desktop app, open Plugins and connect an ApexGenius plugin, or open Settings, then MCP servers, then Add server, and add the ApexGenius MCP address as a Streamable HTTP server. Then open a task in Codex and ask a question about your mail. Start with a read, so nothing is sent.

How do I check that Codex can use Microsoft Outlook?

In the Codex composer, type /mcp to view the connected servers. ApexGenius should be listed. If it asks for sign-in, open Settings, then MCP servers, and select Authenticate. Start a new task, 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 Codex?

Yes. ApexGenius is an MCP server that Codex connects to once. It carries your Outlook connection and 6 Outlook operations, so Codex does not need a separate Outlook integration or plugin. You set it up one time and add each agent the same way.

What can Codex do in Outlook once it is connected?

Codex 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 Codex 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 Codex can list and read mail and folders, and nothing else.

Can Codex send email from my Outlook?

Not until you allow writes. Choose Read only and it cannot send. With writes on, Codex 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 Codex today

Start free

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