Outlook Integration

The Outlook integration provides access to manage Outlook mail, calendars, and contacts through the Integrate MCP server.

Installation

The Outlook integration is included with the SDK:

import { outlookIntegration } from "integrate-sdk/server";

Setup

1. Create an Outlook OAuth App

1. Go to Azure Portal — App Registrations
2. Create a new OAuth application
3. Configure your redirect URI
4. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the Outlook integration to your server configuration. The integration automatically reads OUTLOOK_CLIENT_ID and OUTLOOK_CLIENT_SECRET from your environment variables:

import { createMCPServer, outlookIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    outlookIntegration({
    }),
  ],
});

You can override the environment variables by passing explicit values:

outlookIntegration({
  clientId: process.env.CUSTOM_OUTLOOK_ID,
  clientSecret: process.env.CUSTOM_OUTLOOK_SECRET,
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";

await client.authorize("outlook");
const result = await client.outlook.listMessages({});

console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, outlookIntegration } from "integrate-sdk";

const customClient = createMCPClient({
  integrations: [outlookIntegration()],
});

Configuration Options

Tools

outlook_accept_event

Accept a calendar event invitation

outlook_create_draft

Create a draft message (not sent)

outlook_create_event

Create a new calendar event

outlook_decline_event

Decline a calendar event invitation

outlook_delete_event

Delete a calendar event

outlook_delete_message

Delete a message permanently

outlook_find_meeting_times

Find available meeting times for a set of attendees

outlook_forward_message

Forward a message to one or more recipients

outlook_get_contact

Get a specific contact by ID

outlook_get_event

Get a specific calendar event by ID

outlook_get_message

Get a specific message by ID

outlook_get_schedule

Get free/busy schedule for a set of users or resources

outlook_list_calendars

List all calendars for the authenticated user

No parameters.

outlook_list_contacts

List contacts in the address book

outlook_list_events

List calendar events

outlook_list_mail_folders

List mail folders in the mailbox

outlook_list_messages

List messages in the mailbox

outlook_mark_message_read

Mark a message as read or unread

outlook_move_message

Move a message to another folder

outlook_reply_all_message

Reply all to a message

outlook_reply_message

Reply to a message

outlook_search_messages

Search messages by keyword query

outlook_send_message

Send a new email message

outlook_tentatively_accept_event

Tentatively accept a calendar event invitation

outlook_update_event

Update an existing calendar event

Notes

• Category: Communication
• Authentication mode: OAuth