Read an Outlook calendar

m365_calendar_events · Reads only · Markdown

The events in a mailbox's calendar between two times, in UTC.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

What is in the support calendar next week?

Your agent callsm365_calendar_eventsFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments

{
  "mailbox": "support@hansenvoss.example",
  "start": "2026-10-19T00:00",
  "end": "2026-10-24T00:00",
  "timezone": "Europe/Berlin"
}

What comes back

{
  "mailbox": "support@hansenvoss.example",
  "events": [
    {
      "id": "AAMkAGI2TG93AAA=",
      "subject": "Test kitchen demo: Sophie Lange",
      "start": "2026-10-24T09:30:00.0000000",
      "end": "2026-10-24T10:15:00.0000000",
      "location": "Test kitchen",
      "organizer": "support@hansenvoss.example",
      "attendees": [
        "sophie.lange@example.com"
      ],
      "online_meeting": null,
      "cancelled": false,
      "link": "https://outlook.office365.com/owa/?itemid=AAMkAGI2TG93AAA%3D"
    }
  ]
}

Use it when

Before booking, to find a free slot, or to brief someone on their week.

What it does

The events in a mailbox's calendar between start and end (at most 62 days), in UTC: subject, time, place, organizer, attendees and the Teams link. Free.

What comes back

mailbox; events: each with id, subject, start, end, location, organizer, attendees, online_meeting, cancelled and link. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`mailbox`	string	One of the mailboxes the agent may act as; optional when only one is connected. Up to 254 characters.
`start`Required	string	Up to 40 characters.
`end`Required	string	Up to 40 characters.
`timezone`	string	For start and end without an offset. Up to 60 characters.

The call

Over MCP, call m365_calendar_events on https://api.conecto.chat/mcp/microsoft365. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/m365_calendar_events \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mailbox":"support@hansenvoss.example","start":"2026-10-19T00:00","end":"2026-10-24T00:00","timezone":"Europe/Berlin"}'

When it refuses

A refused call costs nothing and says what to do next.

Code	When	What to do
`not_connected`409	Microsoft 365 isn't connected yet.	Connect it with m365_connect.
`not_allowed`403	The mailbox is not one the agent may act as.	Use a connected mailbox; the owner adds one by connecting again.
`invalid_input`400	A time is not ISO, or end is not after start, or over 62 days.	Send times like 2026-10-20T14:00 with a timezone.

More Microsoft 365 tools

All 11 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md

Read an Outlook calendar

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Microsoft 365 tools

Give this to your agent.