ChatGPT with Microsoft Outlook

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 OAuth client 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 OAuth Client

1. Log in to Caddey: Sign in to your Caddey account and navigate to the Clients section.
2. Add a new client: Click Add Client, name it (e.g., "Outlook Assistant"), choose Confidential as the client type, and optionally add a description like "Manages my Outlook emails via ChatGPT."
3. Leave redirect URI empty for now: We'll get the exact callback URL from ChatGPT in the next steps.
4. Save the client: Click Save. Caddey will generate a Client ID and Client Secret for your OAuth client—copy both now as you'll need them for authentication.

Step 2: Connect Microsoft Outlook in Caddey

1. Open the Apps section: In Caddey's dashboard, go to Apps → Marketplace.
2. Find Outlook: Search for Microsoft Outlook (Mail only) and click Connect.
3. Configure key: A prompt will appear to choose a key. Choose the published OAuth key.
4. Confirm connection: Once connected, Outlook Mail will appear under Apps.

Step 3: Create an Outlook Toolbox

1. Go to Toolboxes: In Caddey, select Toolboxes.
2. Create a new toolbox: Click Create Toolbox. Name it "Outlook Mail Tools" and add a description, e.g., "Tools for managing my Outlook emails."
3. 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 Client

1. Open your client: Return to Clients, and select your "Outlook Assistant" client.
2. Add the toolbox: In the client's Toolboxes tab, click Add Toolbox and choose Outlook Mail Tools.

Step 5: Create a Custom GPT in ChatGPT

1. Open ChatGPT: Log into your ChatGPT Plus/Pro account and click Explore GPTs or Create GPT.
2. Name your GPT: Enter a title, for example, "Email Assistant".
3. 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

1. Add an action: In the GPT builder, click Add Action to configure an external API call.
2. Configure authentication:
   • Method: OAuth
   • Authorization URL: https://auth.caddey.ai/realms/caddey/protocol/openid-connect/auth
   • Token URL: https://auth.caddey.ai/realms/caddey/protocol/openid-connect/token
   • Client ID: Your Caddey OAuth Client ID
   • Client Secret: Your Caddey OAuth Client Secret
   • Scope: openid profile email
3. Copy the Callback URL: After configuring OAuth, ChatGPT will display a callback URL (it will look like https://chat.openai.com/aip/g-{unique-id}/oauth/callback). Copy this URL.
4. Update your Caddey OAuth Client: Go back to your Caddey dashboard, edit the OAuth client you created in Step 1, and add the callback URL you just copied to the Redirect URIs field. Save the client.

5. Import OpenAPI schema: Choose Import OpenAPI from a URL and enter: https://api.caddey.ai/v3/api-docs/tools
6. Verify endpoints: Ensure ChatGPT sees:
   • GET /tools/query (lists available tools)
   • POST /tools/{toolId}/execute (executes a tool)
7. 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:

1. List available tools: Ask, "What tools can you use?"—it should list your Outlook Mail tools.
2. Retrieve emails: Try, "List my recent emails." The GPT will call List messages and display your inbox messages.
3. 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.
4. 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.

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!