# Outlook Calendar

import ToolInfo from "@/app/_components/tool-info";
import Badges from "@/app/_components/badges";
import TabbedCodeBlock from "@/app/_components/tabbed-code-block";
import TableOfContents from "@/app/_components/table-of-contents";
import ToolFooter from "@/app/_components/tool-footer";
import { Callout } from "nextra/components";

<ToolInfo
  description="Enable agents to create and list events in Outlook Calendar."
  author="Arcade"
  authType="oauth2"
  authProviderName="Microsoft"
  versions={["2.1.0"]}
/>

<Badges repo="arcadeai/arcade_outlook_calendar" />

The Arcade Outlook Calendar MCP Server provides pre-built tools for working with calendar events using the Outlook API. Use these tools to:

- Create events
- List events
- Get an event

## Available Tools

These tools are currently available in the Arcade Outlook Calendar MCP Sever.

<TableOfContents
  headers={["Tool Name", "Description"]}
  data={[
    [
      "OutlookCalendar.WhoAmI",
      "Get information about the current user and their Outlook Calendar environment.",
    ],
    [
      "OutlookCalendar.CreateEvent",
      "Create an event in the authenticated user's default calendar",
    ],
    [
      "OutlookCalendar.GetEvent",
      "Get an event by its ID from the user's calendar",
    ],
    [
      "OutlookCalendar.ListEventsInTimeRange",
      "ist events in the user's calendar in a specific time range",
    ],
  ]}
/>

<Callout>
  If you need to perform an action that's not listed here, you can [get in touch
  with us](mailto:contact@arcade.dev) to request a new tool, or [create your own
  tools](/guides/create-tools/tool-basics/build-mcp-server) with the [Google auth
  provider](/references/auth-providers/google#using-google-auth-in-custom-tools).
</Callout>

## OutlookCalendar.WhoAmI

Get information about the current user and their Outlook Calendar environment.

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool with User Authorization",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/microsoft/outlook_calendar/who_am_i_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/microsoft/outlook_calendar/who_am_i_example_call_tool.js",
        ],
      },
    },
  ]}
/>

**Parameters**

This tool does not take any parameters.

---

## OutlookCalendar.CreateEvent

Create an event in the authenticated user's default calendar.

Ignores timezone offsets provided in the start_date_time and end_date_time parameters.
Instead, uses the user's default calendar timezone to filter events.
If the user has not set a timezone for their calendar, then the timezone will be UTC.

**Parameters**

- **`subject`** _(string, required)_: The text of the event's subject (title) line.
- **`body`** _(string, required)_: The body of the event.
- **`start_date_time`** _(datetime, required)_: The datetime of the event's start, represented in ISO 8601 format. Timezone offset is ignored. For example, 2025-04-25T13:00:00
- **`end_date_time`** _(datetime, required)_: The datetime of the event's end, represented in ISO 8601 format. Timezone offset is ignored. For example, 2025-04-25T13:30:00
- **`location`** _(string, optional)_: The location of the event.
- **`attendee_emails`** _(list of strings, optional)_: The email addresses of the attendees of the event. Must be valid email addresses e.g., username@domain.com.
- **`is_online_meeting`** _(bool, optional)_: Whether the event is an online meeting. Defaults to False

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool with User Authorization",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/microsoft/outlook_calendar/create_event_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/microsoft/outlook_calendar/create_event_example_call_tool.js",
        ],
      },
    },
  ]}
/>

---

## OutlookCalendar.GetEvent

Get an event by its ID from the user's calendar.

**Parameters**

- **`event_id`** _(string, required)_: The ID of the event to get.

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool with User Authorization",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/microsoft/outlook_calendar/get_event_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/microsoft/outlook_calendar/get_event_example_call_tool.js",
        ],
      },
    },
  ]}
/>

---

## OutlookCalendar.ListEventsInTimeRange

List events in the user's calendar in a specific time range.

Ignores timezone offsets provided in the start_date_time and end_date_time parameters.
Instead, uses the user's default calendar timezone to filter events.
If the user has not set a timezone for their calendar, then the timezone will be UTC.

**Parameters**

- **`start_date_time`** (datetime, required): The start date and time of the time range, represented in ISO 8601 format. Timezone offset is ignored. For example, 2025-04-24T19:00:00
- **`end_date_time`** (datetime, required): The end date and time of the time range, represented in ISO 8601 format. Timezone offset is ignored. For example, 2025-04-24T19:30:00
- **`limit`** (int, optional): The maximum number of events to return. Max 1000. Defaults to 10.

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool with user authorization",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/microsoft/outlook_calendar/list_events_in_time_range_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/microsoft/outlook_calendar/list_events_in_time_range_example_call_tool.js",
        ],
      },
    },
  ]}
/>

---

## Auth

The Arcade Outlook Calendar MCP Sever uses the [Microsoft auth provider](/references/auth-providers/microsoft) to connect to users' Microsoft accounts.

With the Arcade Cloud Platform, there's nothing to configure. Your users will see `Arcade` as the name of the application that's requesting permission.

With a self-hosted installation of Arcade, you need to [configure the Microsoft auth provider](/references/auth-providers/microsoft#configuring-microsoft-auth) with your own Microsoft app credentials.

---

<ToolFooter pipPackageName="arcade_outlook_calendar" />