add-office365 — Claude Code skill: Office 365 Outlook for Power Apps
add-office365 connects Office 365 Outlook to Power Apps code app. Provides calendar access, email sending, inbox reading and event management.
MIT ★ 1,167 updated 2026-10-29
/plugin marketplace add microsoft/power-platform-skills
/plugin install code-apps-preview@power-platform-skillsWhat add-office365 does
The skill integrates Office 365 Outlook into Power Apps code app through a connector. It generates Office365OutlookService.ts with methods for calendar operations (GetEventsCalendarViewV2, V3CalendarPostItem, CalendarDeleteItem), email handling (SendEmailV2, GetEmails, ReplyToV3) and contact management. Before adding the connector, it calls /list-connections to locate an existing connection or direct you to create one.
Follows a six-step flow: check memory-bank.md, add the connector via pa app add data-source --connector office365 -c <connection-id>, grep for needed methods, configure operations (events, email, contacts), build with npm run build, and update Memory Bank. Creating a calendar event requires Subject, Start, End in ISO 8601 format; sending email requires To, Subject and HTML Body.
Requires an active Office 365 connection in your Power Platform environment. The environment ID comes from power.config.json or context; if no connection exists, the skill provides a link https://make.powerapps.com/environments/<environment-id>/connections to create one.
What it helps with
- connect Office 365 Outlook to Power Apps code app
- fetch calendar events for a date range
- create, delete or update Outlook events
- send email through Office 365 from app
- read inbox or reply to messages
Example prompts for the agent
- Add Office 365 Outlook, I need calendar and email operations
- Connect Office 365, show me how to get events for June
- Create a calendar event on June 15 from 10:00 to 11:00, subject Focus Time
How to install add-office365
1Plugin marketplace
/plugin marketplace add microsoft/power-platform-skills/plugin install code-apps-preview@power-platform-skillsThis installs the whole code-apps-preview plugin with all its skills
2Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-office365 -a claude-code3Manually: put the files in place
~/.claude/skills/add-office365/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/add-office365/
1Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-office365 -a codex2Manually: put the files in place
.agents/skills/add-office365/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-office365 -a cursor2Manually: put the files in place
.cursor/skills/add-office365/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install microsoft/power-platform-skills plugins/code-apps/skills/add-office3652Manually: put the files in place
.github/skills/add-office365/SKILL.md1Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-office365 -a gemini-cli2Platform CLI
gemini skills install https://github.com/microsoft/power-platform-skills --path plugins/code-apps/skills/add-office365Manually: put the files in place
.devin/skills/add-office365/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about add-office365
How to install add-office365 in Claude Code?
Run /plugin marketplace add microsoft/power-platform-skills, then /plugin install code-apps-preview@power-platform-skills. The skill will be at ~/.claude/skills/add-office365/SKILL.md.
What does add-office365 do?
Adds the Office 365 Outlook connector to a Power Apps code app and generates a service for calendar, email and contact operations. Includes methods for creating events, sending email, reading inbox and managing contacts.
What does add-office365 require?
An active Office 365 Outlook connection in your Power Platform environment. If none exists, the skill will direct you to create one at https://make.powerapps.com/environments/<environment-id>/connections.
Source text
SKILL.md · MIT
---
name: add-office365
description: Adds Office 365 Outlook connector to a Power Apps code app. Use when accessing calendars, sending emails, reading inbox, or managing Outlook events.
user-invocable: true
allowed-tools: Read, Edit, Write, Grep, Glob, Bash, LSP, TaskCreate, TaskUpdate, TaskList, TaskGet, AskUserQuestion, Skill
model: sonnet
---
**📋 Shared Instructions: [shared-instructions.md](${PLUGIN_ROOT}/shared/shared-instructions.md)** - Cross-cutting concerns.
# Add Office 365 Outlook
## Workflow
1. Check Memory Bank -> 2. Add Connector -> 3. Review Generated Service -> 4. Configure -> 5. Build -> 6. Update Memory Bank
---
### Step 1: Check Memory Bank
Check for `memory-bank.md` per [shared-instructions.md](${PLUGIN_ROOT}/shared/shared-instructions.md).
### Step 2: Add Connector
**First, find the connection ID** (see [connector-reference.md](${PLUGIN_ROOT}/shared/connector-reference.md)):
Run the `/list-connections` skill. Find the Office 365 Outlook connection in the output (API name contains `office365`). If none exists, direct the user to create one using the environment-specific Connections URL — construct it from the active environment ID in context (from `power.config.json` or a prior step): `https://make.powerapps.com/environments/<environment-id>/connections` → **+ New connection** → search for the connector → Create.
```bash
pa app add data-source --connector office365 -c <connection-id>
```
### Step 3: Review Generated Service
The generated service file (`src/generated/services/Office365OutlookService.ts`) is large. **Use `Grep` to find specific methods** instead of reading the entire file:
```
Grep pattern="async \w+" path="src/generated/services/Office365OutlookService.ts"
```
Key methods (sorted by common usage):
#### Calendar Operations
| Method | Purpose | Key Parameters |
| ------------------------- | -------------------------- | -------------------------------------------------------- |
| `GetEventsCalendarViewV2` | Get events in a date range | `calendarId`, `startDateTimeOffset`, `endDateTimeOffset` |
| `V3CalendarPostItem` | Create a calendar event | `table` (calendar ID), `item` (CalendarEventHtmlClient) |
| `CalendarDeleteItem` | Delete an event | `table` (calendar ID), `id` (event ID) |
| `CalendarPatchItem` | Update an event | `table`, `id`, `item` |
| `V2CalendarGetTables` | List available calendars | (none) |
#### Email Operations
| Method | Purpose | Key Parameters |
| ----------------- | ------------------ | ---------------------------------------- |
| `SendEmailV2` | Send an email | `emailMessage` (body, to, subject, etc.) |
| `GetEmails` | Get inbox emails | `folderPath`, `fetchOnlyUnread`, `top` |
| `GetEmail` | Get single email | `messageId` |
| `MarkAsRead` | Mark email as read | `messageId` |
| `ReplyToV3` | Reply to an email | `messageId`, `body` |
| `Flag` / `Unflag` | Flag/unflag email | `messageId` |
#### Contact Operations
| Method | Purpose |
| ------------------- | -------------------- |
| `GetContactFolders` | List contact folders |
| `ContactGetTables` | List contact tables |
### Step 4: Configure
Ask the user what Office 365 Outlook operations they need (skip if already specified by caller).
**Calendar -- Get events for a date range:**
```typescript
import { Office365OutlookService } from "../generated/services/Office365OutlookService";
const result = await Office365OutlookService.GetEventsCalendarViewV2(
"Calendar", // calendarId -- "Calendar" for default
startDate.toISOString(),
endDate.toISOString()
);
const events = result.data?.value || [];
```
**Calendar -- Create an event:**
```typescript
await Office365OutlookService.V3CalendarPostItem("Calendar", {
Subject: "Focus Time",
Start: "2025-06-15T10:00:00", // ISO 8601 format
End: "2025-06-15T11:00:00",
ShowAs: "Busy",
Importance: "Normal",
IsAllDay: false,
Body: "<p>Blocked for focus work</p>",
Reminder: 5
});
```
**Calendar -- Delete an event:**
```typescript
await Office365OutlookService.CalendarDeleteItem("Calendar", eventId);
```
**Email -- Send an email:**
```typescript
await Office365OutlookService.SendEmailV2({
To: "<recipient-address>",
Subject: "Subject line",
Body: "<p>HTML email body</p>",
Importance: "Normal"
});
```
**Key types:**
| Type | Purpose |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `CalendarEventClientReceiveStringEnums` | Read model -- has `Subject`, `Start`, `End`, `Id`, `ShowAs`, `IsAllDay`, `Organizer` |
| `CalendarEventHtmlClient` | Write model -- requires `Subject`, `Start`, `End`; optional `Body`, `ShowAs`, `Importance`, `Reminder` |
| `EntityListResponse_CalendarEventClientReceiveStringEnums` | Response wrapper -- access events via `.value` |
**Response pattern:**
```typescript
const result = await Office365OutlookService.GetEventsCalendarViewV2(...);
if (result.success) {
const events = result.data?.value || [];
} else {
console.error("Failed:", result.error);
}
```
### Step 5: Build
```bash
npm run build
```
Fix TypeScript errors before proceeding. Do NOT deploy yet.
### Step 6: Update Memory Bank
Update `memory-bank.md` with: connector added, configured operations, build status.
© Microsoft · MIT · microsoft/power-platform-skills