> For the complete documentation index, see [llms.txt](https://docs.darcyiq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.darcyiq.com/build/integration-overview/enterprise/outlook.md).

# Microsoft Outlook

The **Microsoft Outlook** integration lets Darcy Chat and AI agents work with your Outlook email and calendar — listing and searching messages, reading threads, drafting and sending email, and scheduling events — through natural conversation. It's a personal, user-level connection: you sign in to Microsoft and grant DarcyIQ access, and the connection acts on **your** account only.

{% hint style="success" %}
**Email and calendar, hands-free**: Say *"Reply to the latest message from the client confirming Thursday, and add a 30-minute calendar hold,"* and Darcy drafts the reply and creates the event for you.
{% endhint %}

{% hint style="info" %}
**Beta**: Microsoft Outlook is currently a Beta integration available under **Settings → Integrations**.
{% endhint %}

## Overview

| Capability           | Function                                     | Business Impact                     |
| -------------------- | -------------------------------------------- | ----------------------------------- |
| **Natural Language** | Manage email and calendar through chat       | No switching to Outlook             |
| **Email Management** | List, read, search, reply, and send messages | Stay on top of your inbox           |
| **Draft Workflow**   | Create and edit drafts before sending        | Review before anything goes out     |
| **Calendar**         | List, view, and create events with attendees | Schedule without leaving the chat   |
| **Agent & Workflow** | Available to AI agents and AI Workflows      | Automate email and scheduling steps |

## What You Can Do

### Email

| Action     | Natural Language Example                         | Result                              |
| ---------- | ------------------------------------------------ | ----------------------------------- |
| **List**   | "Show my most recent inbox messages"             | A list of recent emails             |
| **Search** | "Find emails mentioning the SOW from last month" | Matching messages                   |
| **Read**   | "Read the message from Dana about onboarding"    | The email body and attachments info |
| **Draft**  | "Draft a follow-up to the client thread"         | A saved Outlook draft               |
| **Reply**  | "Reply to that thread confirming the date"       | A threaded reply (sent on request)  |
| **Send**   | "Send an email to the team with the notes"       | The email is sent                   |

### Calendar

| Action           | Natural Language Example                              | Result                       |
| ---------------- | ----------------------------------------------------- | ---------------------------- |
| **List events**  | "What's on my calendar next week?"                    | Upcoming events in the range |
| **Event detail** | "Show details for the kickoff meeting"                | Full event details           |
| **Create event** | "Schedule a 30-minute review Friday at 2pm with Alex" | A new event with invitations |

{% hint style="info" %}
Darcy uses a **draft-first** approach for email: creating and editing drafts requires no approval, but actually **sending** requires your explicit go-ahead. You can also attach files Darcy has generated.
{% endhint %}

## Connecting Microsoft Outlook

Connecting is a one-time OAuth sign-in. DarcyIQ never sees your Microsoft password — authentication happens on Microsoft's own consent screen.

{% stepper %}
{% step %}
**Open Integrations** Go to **User Configuration → Integrations**.
{% endstep %}

{% step %}
**Find Microsoft Outlook** Locate the **Microsoft Outlook** integration and click **Connect**.
{% endstep %}

{% step %}
**Sign in to Microsoft** You're redirected to Microsoft's sign-in and consent screen. Choose the account you want to use.
{% endstep %}

{% step %}
**Approve the DarcyIQ connection** Review the requested permissions and accept. You're returned to DarcyIQ with the integration marked **Connected**.
{% endstep %}
{% endstepper %}

To revoke access later, disconnect the integration in DarcyIQ and/or remove DarcyIQ from your Microsoft account's app permissions.

## Using Outlook in Chat & Agents

Once connected, Outlook is available wherever Darcy can use tools:

* **Darcy Chat** — manage email and calendar in plain language.
* **AI Agents** — agents can include email and scheduling steps in a larger task.
* **AI Workflows** — automate recurring actions such as drafting follow-ups or holding time after a meeting.

## Permissions & Security

| Aspect          | Detail                                                                                     |
| --------------- | ------------------------------------------------------------------------------------------ |
| **Scope**       | Personal (user-level) — the connection only ever touches your own mailbox and calendar     |
| **Auth method** | OAuth — you sign in with Microsoft and approve DarcyIQ; your password is never shared      |
| **Sending**     | Email is sent only when you explicitly request it                                          |
| **Revoking**    | Disconnect any time from Settings → Integrations or your Microsoft account app permissions |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.darcyiq.com/build/integration-overview/enterprise/outlook.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
