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 agent and connect tools.
• Caddey plugin URL – https://api.caddey.ai/.well-known/ai-plugin.json

---

Step 1: Create a Caddey Agent

1. Sign in to Caddey and open Agents → Add Agent.
2. Fill in a name/description and click Save.
3. Copy the API key and store it safely.
4. Share the toolboxes you want Copilot to use with this agent.

---

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, paste the agent’s API key in the X-API-KEY field.
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.