Create event
create_eventCreate calendar events and meetings in Microsoft 365, email invitations to attendees immediately, and optionally add a Microsoft Teams link.
Instructions
Create a calendar event. If attendees are given this is a meeting and invitations are emailed to them immediately. Set isOnlineMeeting to add a Microsoft Teams link (if the tenant allows it).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"subject": "<subject>",
"start": "<start>"
},
"name": "create_event"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | End. ISO 8601. With an offset (2026-11-02T14:00:00Z or +01:00) it is exact; without one it is local time in timeZone, or in the mailbox time zone if timeZone is omitted. For all-day events the day after the last day (exclusive) | |
| body | No | Description / agenda | |
| start | Yes | Start. ISO 8601. With an offset (2026-11-02T14:00:00Z or +01:00) it is exact; without one it is local time in timeZone, or in the mailbox time zone if timeZone is omitted. For all-day events a date (YYYY-MM-DD) | |
| showAs | No | Free/busy status | |
| subject | Yes | Title | |
| calendar | No | Calendar (default: the main calendar). Accepts a well-known name (inbox, drafts, sentitems/sent, deleteditems/trash, junkemail/junk, archive, outbox), a display name or path such as "Inbox/Projects", or a folder ID from list_folders | |
| isAllDay | No | All-day event | |
| location | No | Location text | |
| timeZone | No | IANA time zone for start/end without an offset, e.g. "Europe/London" | |
| attendees | No | Required attendees: email addresses, either "jane@contoso.com" or "Jane Doe <jane@contoso.com>" | |
| bodyFormat | No | Body format: "text" (default) or "html" | |
| categories | No | Category names | |
| recurrence | No | Make the event repeat | |
| sensitivity | No | ||
| isOnlineMeeting | No | Add a Teams meeting link | |
| optionalAttendees | No | Optional attendees: email addresses, either "jane@contoso.com" or "Jane Doe <jane@contoso.com>" | |
| reminderMinutesBefore | No | Reminder in minutes before start; null disables the reminder |