Microsoft Copilot with Caddey

This guide shows how to add Caddey's ready-made plugin to Microsoft Copilot (free or Pro).
After a one-time setup Copilot can list your Caddey tools and execute them on demand.

Prerequisites

• Microsoft Copilot account – works with both the free tier and Copilot Pro.
• Caddey account: A Caddey account to create an OAuth client and connect tools.
• Caddey plugin URL – https://api.caddey.ai/.well-known/ai-plugin.json

---

Step 1: Create a Caddey OAuth Client

1. Sign in to Caddey and open Clients → Add client.
2. Fill in a name/description (e.g., "Microsoft Copilot"), choose Confidential as client type.
3. In the Redirect URIs field, add: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
4. Click Save.
5. Note the Client ID and Client Secret and store them safely.
6. Share the toolboxes you want Copilot to use with this OAuth client.

---

Step 2: Add the Plugin in Copilot

1. Open copilot.microsoft.com (or the Copilot desktop/mobile app) and sign in.
2. Go to Plugins → My Plugins → Add custom plugin.
3. Paste the plugin URL: https://api.caddey.ai/.well-known/ai-plugin.json
4. When prompted for authentication, configure 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 Client ID from Step 1
   • Client Secret: Your Client Secret from Step 1
5. Confirm. The Caddey plugin appears in your enabled list.

---

Step 3: Test Your Connection

1. In Copilot chat, ask:
   "What Caddey tools are available?"
   Copilot should return a list via GET /tools/query.
2. Run a tool, e.g.:
   "Use the Send Email Caddey tool to email my team about tomorrow's demo."
   Copilot will call POST /tools/{toolId}/execute and confirm success.

---

All Set

Copilot now taps Caddey in real time—just ask it to use your tools.