ChatGPT with Microsoft Calendar

In this tutorial, you'll learn how to integrate Microsoft Calendar with ChatGPT using Caddey. By setting up a custom GPT that connects to Caddey, you'll be able to view your calendar events, create new appointments, and manage your schedule directly from a ChatGPT conversation – all without writing any code. Let's get started!

Prerequisites

Make sure you have the following ready before you begin:

• 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 Calendar.
• Microsoft account with Calendar access: A personal or work Microsoft account that you use with Microsoft Calendar (Outlook Calendar). You'll use this to authorize Caddey to manage your calendar events.

Step 1: Create a Caddey OAuth Client

First, set up an OAuth client in Caddey to act as the bridge between ChatGPT and Microsoft Calendar:

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., "Calendar Assistant"), choose Confidential as the client type, and optionally add a description like "Manages my calendar events 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 Calendar in Caddey

Next, connect your Microsoft Calendar account to Caddey as an app:

1. Go to Caddey Apps: In the Caddey dashboard, navigate to the Apps section and open the Marketplace.
2. Find Microsoft Calendar: Browse or search the marketplace for Microsoft Calendar or Microsoft Outlook Calendar. Once you find it, click the Connect button on the Microsoft Calendar app.
3. Configure key: A prompt will appear to choose a key. Choose the published OAuth key.
4. Complete the connection: After connecting, the Microsoft Calendar app will be added to your Caddey account. You should see Microsoft Calendar listed under your connected apps.

Step 3: Create a Toolbox for Microsoft Calendar

Caddey uses toolboxes to group related tools (actions) from your apps. This step shows how to create a toolbox to organize Microsoft Calendar tools.

1. Navigate to Toolboxes: In your Caddey dashboard, go to the Toolboxes section.
2. Create a new toolbox: Click Create Toolbox. Give your toolbox a name, for example, "Microsoft Calendar Tools", and add a description (like "Tools to manage my calendar events"). Save the new toolbox.
3. Add Calendar tools: With your toolbox created, click Add Tools to add tools to it. From the list of available tools, select the ones related to Microsoft Calendar – for example:
   • Get Calendar View (to retrieve events within a time range)
   • List Calendar Events (to retrieve all calendar events)
   • Create Calendar Event (to add new appointments)
   • Get Calendar Event (to view details of a specific event)
   • Update Calendar Event (to modify existing events)
   • Delete Calendar Event (to remove events)
   You can choose any other Microsoft Calendar actions you see and want to use.

Step 4: Assign the Toolbox to Your Client

Now link the Microsoft Calendar tools to the Caddey OAuth client you created:

1. Open your client settings: Go back to the Clients section and select the client you created in Step 1 (e.g., "Calendar Assistant").
2. Add a toolbox to the client: In the client's toolboxes tab, find the option to Add Toolbox. Click this and choose the Microsoft Calendar Tools toolbox you created in Step 3 from the list.

Step 5: Create a Custom GPT in ChatGPT

With Caddey set up, the next part is in ChatGPT. We'll create a custom GPT (a personalized ChatGPT instance) that can use the Caddey client's tools:

1. Open ChatGPT settings: Log in to your ChatGPT Plus/Pro account. In the ChatGPT interface, find and click on Explore GPTs (or a section for custom GPTs/GPT builder).
2. Start a new GPT: Click the Create (or New GPT) button to begin making a custom GPT.
3. Enter a title: Give your custom GPT a name. For example, "Calendar Assistant". This will be the name of the assistant (you'll see it in your GPT list).
4. Add a description: Provide a short description, such as "Helps manage my Microsoft Calendar events via Caddey" – this is just for your reference or if you share the GPT with others.
5. (Optional) Add instructions or personality: You can add some instructions or a prompt to guide how this assistant behaves. For instance, you might note that it can manage calendar events and should use the Caddey tools when appropriate. (This step is optional, but you could include a friendly greeting or usage tips for the assistant here.)

After filling in the basic details, you're ready to connect the GPT to Caddey's API.

Step 6: Connect the GPT to Caddey

Now we'll link your custom GPT to the Caddey client's tools using an OAuth action:

1. Add a new action: In the GPT builder interface, find the option to Add Action (this lets your GPT call external APIs).
2. Configure authentication: Set up OAuth authentication for your Caddey client:
   • 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 offline_access
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 Caddey's OpenAPI schema: Next, load the definition of Caddey's tools API so ChatGPT knows what actions are available:

   • Choose the option to Import OpenAPI schema (from a URL).
   • Enter the URL: https://api.caddey.ai/v3/api-docs/tools and import it.

6. Confirm the tools endpoints: After importing, you should see that ChatGPT has loaded the Caddey tools endpoints. In particular, look for:

   • GET /tools/query – used to search or list the available tools your client can access.
   • POST /tools/{toolId}/execute – used to execute a specific tool (like listing events or creating an event).

   These are the actions ChatGPT will use to interact with your Microsoft Calendar tools via Caddey.

7. Save the action: Once everything is configured, save or confirm this new action in the GPT builder. Your custom GPT is now configured to communicate with Caddey.

Step 7: Test the Integration in ChatGPT

It's time to try out your new GPT and make sure everything works as expected. Use the preview mode in the GPT builder or save and start a conversation with your custom GPT:

1. Ask for available tools: Start by asking your assistant something like "What tools do you have?" or "What can you do?" The GPT will call Caddey's /tools/query endpoint to retrieve the list of tools. It should respond with the tools you added, for example, a list that includes Get Calendar View, Create Calendar Event, and other calendar management tools.

2. View your calendar: Now, ask the assistant to show your upcoming events. You can say something like "What's on my calendar today?" or "Show me my events for this week." The GPT will use the Get Calendar View tool via Caddey to fetch your current Microsoft Calendar events and display them in the chat. (If you have events scheduled, you should see them listed with times, titles, and locations.)

3. Create a new event: Test adding an event. For example, type: "Schedule a meeting with the team tomorrow at 2 PM for 1 hour." The assistant will use the Create Calendar Event tool and attempt to create a new event in your Microsoft Calendar with the specified details. It should then respond confirming that the event was created.

4. Get event details: Try asking for specific event information: "Tell me more about my 2 PM meeting tomorrow." The GPT can use the Get Calendar Event tool to retrieve detailed information about specific events.

5. Verify the action: (Optional) You can open your Microsoft Calendar app, Outlook, or the web interface and check that the new meeting appears at the scheduled time. This confirms the integration is working correctly with real data!

If each of these steps works, congratulations – ChatGPT is now successfully talking to Microsoft Calendar through Caddey!

Advanced Usage Examples

Once your Calendar Assistant is working, here are some advanced ways to use it:

• Schedule recurring meetings: "Set up a weekly team standup every Monday at 9 AM starting next week."
• Check availability: "Am I free next Friday afternoon?"
• Reschedule events: "Move my 3 PM meeting to 4 PM tomorrow."
• Add event details: "Add the Zoom link and agenda to my project review meeting."
• Delete events: "Cancel my dentist appointment next Tuesday."
• View specific time ranges: "Show me all my meetings for next month."
• Create detailed events: "Schedule a client presentation on Thursday from 10-11 AM in Conference Room A, and invite [email protected] and [email protected]."

Finalize and Deploy Your Custom GPT

Once you're satisfied that everything is functioning, click Save (or Done) to finalize your custom GPT. Your new "Calendar Assistant" will now be available in your ChatGPT interface for you to chat with whenever you need it.

Going forward, you can simply start a conversation with this GPT and ask it to manage your calendar. For example, "What meetings do I have today?" or "Schedule lunch with Sarah next week" – and the assistant will carry out the request via Caddey.

You're all set! You have successfully created a ChatGPT assistant that works with Microsoft Calendar. Enjoy the convenience of managing your schedule through natural language, and stay organized with your new AI-powered calendar assistant!