ChatGPT with Microsoft Outlook
Learn how to build a custom GPT in ChatGPT that manages emails in Microsoft Outlook using Caddey — no coding required.
May 28, 2025
In this tutorial, you'll learn how to integrate Microsoft Outlook with ChatGPT using Caddey. By setting up a custom GPT that connects to Caddey, you'll be able to list your emails, reply to messages, and send new emails directly from a ChatGPT conversation – all without writing any code. Let's get started!
Prerequisites
- ChatGPT Plus/Pro subscription: Access to custom GPT creation features in ChatGPT.
- Caddey account: A Caddey account to create an agent and connect Microsoft Outlook.
- Microsoft account with Outlook access: A personal or work Microsoft account that you use with Outlook.
Step 1: Create a Caddey Agent
- Log in to Caddey: Sign in to your Caddey account and navigate to the Agents section.
- Add a new agent: Click Add Agent, name it (e.g., "Outlook Agent"), and optionally add a description like "Manages my Outlook emails via Caddey."
- Save the agent: Click Save. Caddey will generate an API Key for your agent—copy it now as you won’t see it again.
The Caddey agent acts as the identity for your assistant. Its API key allows ChatGPT to securely call Outlook actions through Caddey.
Step 2: Connect Microsoft Outlook in Caddey
- Open the Apps section: In Caddey’s dashboard, go to Apps → Marketplace.
- Find Outlook: Search for Microsoft Outlook (Mail only) and click Connect.
- Configure key: A prompt will appear to choose a key. Choose the published OAuth key.
- Confirm connection: Once connected, Outlook Mail will appear under Apps.
Step 3: Create an Outlook Toolbox
- Go to Toolboxes: In Caddey, select Toolboxes.
- Create a new toolbox: Click Create Toolbox. Name it "Outlook Mail Tools" and add a description, e.g., "Tools for managing my Outlook emails."
- Add Outlook tools: Click Add Tools and select the following actions:
- List messages in the signed-in user’s mailbox
- Create a draft message
- Send a message (or draft)
- Reply to a message (send directly)
Step 4: Assign the Toolbox to Your Agent
- Open your agent: Return to Agents, and select your "Outlook Agent."
- Add the toolbox: In the agent’s Toolboxes tab, click Add Toolbox and choose Outlook Mail Tools.
Step 5: Create a Custom GPT in ChatGPT
- Open ChatGPT: Log into your ChatGPT Plus/Pro account and click Explore GPTs or Create GPT.
- Name your GPT: Enter a title, for example, "Email Assistant".
- Add a description: Something like "Helps manage my Outlook emails via Caddey". Optionally, add usage tips or personality notes.
Step 6: Connect the GPT to Caddey
- Add an action: In the GPT builder, click Add Action to configure an external API call.
- Configure authentication:
- Method: API Key
- Key location: Custom Header
- Header name:
X-API-KEY
- Value: Paste your Caddey agent API key.
If you need to revoke access, regenerate or delete the agent’s API key in Caddey.
- Import OpenAPI schema: Choose Import OpenAPI from a URL and enter:
https://api.caddey.ai/v3/api-docs/tools
- Verify endpoints: Ensure ChatGPT sees:
- GET
/tools/query
(lists available tools) - POST
/tools/{toolId}/execute
(executes a tool)
- GET
- Save the action: Confirm and save—your custom GPT is now linked to Caddey.
Step 7: Test Your Email Assistant
Switch to the preview or start a chat with your new GPT:
- List available tools: Ask, "What tools can you use?"—it should list your Outlook Mail tools.
- Retrieve emails: Try, "List my recent emails." The GPT will call List messages and display your inbox messages.
- Reply to an email: Prompt, "Reply to the first email saying 'Thanks for your update, I'll review and get back to you.'" It will use the Reply to a message tool.
- Send a new email: Ask, "Send an email to [email protected] with subject 'Meeting Follow-Up' and body 'Thanks for meeting today. Let's stay in touch.'" The GPT will create a draft and send it.
You can expand functionality anytime by adding more Outlook actions or connecting other apps in Caddey—just update your toolbox and reassign it to the agent.
Finalize and Deploy Your GPT
Once testing succeeds, click Save or Done in the GPT builder. Your Email Assistant will now appear in your ChatGPT interface—ready to manage your Outlook mail via natural language.
Happy emailing!