> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Outlook

**Authentication:** OAuth or access token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Find every email from contacts at our top-10 accounts in the last 7 days I haven't replied to.
* Draft a follow-up reply to the latest message from `customer@acme.com`.
* Search for emails with `invoice` from this month and forward to accounting\@.

## Available Tools

#### list\_message\_attachments

List all attachments for a specific email message with pagination support.

#### get\_message\_attachment

Get a specific attachment from an email message by ID.

#### get\_message\_attachments\_metadata

Get metadata for all attachments in an email message without downloading content. Returns only essential fields (id, name, size, contentType) with pagination support.

#### get\_events

Retrieve calendar events within a time range with pagination support.

#### get\_event

Get a specific calendar event by ID

#### create\_event

Create a calendar event (one-time or recurring). Use recurrence parameter for recurring events.

#### update\_event

Update a calendar event.

#### delete\_event

Delete a calendar event

#### get\_today\_events

Get today's calendar events

#### get\_upcoming\_events

Get upcoming calendar events

#### get\_past\_events

Get past calendar events from previous days

#### create\_meeting

Create a meeting with attendees (one-time or recurring)

#### create\_teams\_meeting

Create a Teams meeting with enhanced online meeting support

#### search\_events

Search for calendar events with pagination support

#### get\_user\_schedule

Get free/busy schedule information for users, distribution lists, or resources for a specified time period

#### find\_meeting\_times

Find optimal meeting times based on attendee availability, suggesting times that work for required participants

#### get\_contacts

Retrieve contacts from a folder with pagination support

#### get\_contact

Get a specific contact by ID

#### create\_contact

Create a new contact

#### update\_contact

Update a contact

#### delete\_contact

Delete a contact

#### search\_contacts

Search for contacts with pagination support

#### find\_contacts\_by\_email

Find contacts by email address with pagination support

#### find\_contacts\_by\_company

Find contacts by company name with pagination support

#### get\_mail\_folders

Get all mail folders with pagination support

#### get\_mail\_folder

Get a specific mail folder by ID

#### create\_mail\_folder

Create a new mail folder

#### update\_mail\_folder

Update a mail folder

#### delete\_mail\_folder

Delete a mail folder

#### copy\_mail\_folder

Copy a mail folder

#### move\_mail\_folder

Move a mail folder

#### get\_child\_folders

Get child folders of a parent folder with pagination support

#### get\_well\_known\_folder

Get a well-known folder by name

#### get\_folder\_message\_count

Get message counts for a folder

#### get\_messages

Retrieve messages from a mailbox folder with pagination support

#### get\_message

Get a specific message by ID

#### create\_draft\_message

Create a draft message

#### send\_message

Send an email message

#### update\_message

Update a message

#### delete\_message

Delete a message

#### mark\_message\_as\_read

Mark a message as read

#### mark\_message\_as\_unread

Mark a message as unread

#### get\_unread\_messages

Get unread messages from a folder with pagination support

#### search\_messages

Search for messages with pagination support. Returns message IDs that are 150+ characters long. ⚠️ CRITICAL: Copy the ENTIRE 'id' field exactly - do NOT truncate or reconstruct IDs.

#### list\_users

List users in the organization with pagination support, filtering, ordering

#### search\_users

Search for users by name, email with pagination support and full-text search

#### get\_user\_by\_email

Get detailed user information by email address (userPrincipalName)