What can you do with it?

Microsoft Outlook allows you to manage your email, calendar, and tasks programmatically through the Microsoft Graph API. You can send and receive emails, create and manage calendar events, work with todo lists and tasks, handle email attachments, organize messages in folders, and search through your communications. This integration is perfect for email automation, calendar scheduling, task management, and unified communication workflows.

How to use it?

Basic Command Structure

/your-Microsoft-Outlook-connection [action] [required-parameters] [optional-parameters]

Parameters

Required:

  • action - The operation to perform with Outlook

Tools

Send Email

Send an email message

Parameters:

  • to (required) - Recipient email address
  • subject (required) - Email subject
  • body (required) - Email content
  • cc (optional) - CC recipients
  • importance (optional) - Email importance level

Example:

/your-Microsoft-Outlook-connection
action: send-email
to: john@company.com
subject: Project Update
body: Here's the latest status on our project...
importance: high

Response:

{
  "id": "AAMkAGI2...",
  "subject": "Project Update",
  "bodyPreview": "Here's the latest status...",
  "sentDateTime": "2024-03-15T10:30:00Z"
}

List Emails

Get a list of emails from your inbox

Parameters:

  • folder (optional) - Mail folder to list from
  • limit (optional) - Number of emails to retrieve
  • unread-only (optional) - Show only unread messages

Example:

/your-Microsoft-Outlook-connection
action: list-emails
folder: inbox
limit: 10
unread-only: true

Response:

{
  "value": [
    {
      "id": "AAMkAGI2...",
      "subject": "Meeting Tomorrow",
      "from": {
        "emailAddress": {
          "address": "sender@example.com"
        }
      },
      "isRead": false,
      "receivedDateTime": "2024-03-15T09:00:00Z"
    }
  ]
}

Search Emails

Search for emails by query

Parameters:

  • query (required) - Search query text
  • folder (optional) - Folder to search in

Example:

/your-Microsoft-Outlook-connection
action: search-emails
query: project proposal

Response:

{
  "value": [
    {
      "id": "AAMkAGI2...",
      "subject": "Re: Project Proposal",
      "bodyPreview": "I've reviewed the project proposal...",
      "from": {
        "emailAddress": {
          "address": "manager@company.com"
        }
      }
    }
  ]
}

Create Calendar Event

Create a new calendar event

Parameters:

  • subject (required) - Event title
  • start (required) - Start date/time (ISO format)
  • end (required) - End date/time (ISO format)
  • location (optional) - Event location
  • attendees (optional) - Comma-separated email addresses
  • body (optional) - Event description

Example:

/your-Microsoft-Outlook-connection
action: create-event
subject: Team Meeting
start: 2024-03-20T14:00:00
end: 2024-03-20T15:00:00
location: Conference Room A
attendees: team@company.com

Response:

{
  "id": "AAMkAGI2...",
  "subject": "Team Meeting",
  "start": {
    "dateTime": "2024-03-20T14:00:00",
    "timeZone": "UTC"
  },
  "end": {
    "dateTime": "2024-03-20T15:00:00",
    "timeZone": "UTC"
  },
  "location": {
    "displayName": "Conference Room A"
  }
}

List Calendar Events

Get calendar events within a date range

Parameters:

  • start-date (optional) - Start date for event listing
  • end-date (optional) - End date for event listing
  • limit (optional) - Maximum number of events

Example:

/your-Microsoft-Outlook-connection
action: list-events
start-date: 2024-03-15
end-date: 2024-03-22

Response:

{
  "value": [
    {
      "id": "AAMkAGI2...",
      "subject": "Weekly Standup",
      "start": {
        "dateTime": "2024-03-18T09:00:00"
      },
      "end": {
        "dateTime": "2024-03-18T09:30:00"
      },
      "isAllDay": false
    }
  ]
}

List Todo Lists

Get all todo lists

Parameters:

  • None required

Example:

/your-Microsoft-Outlook-connection
action: list-todo-lists

Response:

{
  "value": [
    {
      "id": "AAMkAGI2...",
      "displayName": "Work Tasks",
      "isOwner": true
    },
    {
      "id": "BBMkAGI3...",
      "displayName": "Personal",
      "isOwner": true
    }
  ]
}

Create Task

Create a new task in a todo list

Parameters:

  • list-id (required) - ID of the todo list
  • title (required) - Task title
  • due-date (optional) - Due date for the task
  • importance (optional) - Task importance (low, normal, high)
  • body (optional) - Task description

Example:

/your-Microsoft-Outlook-connection
action: create-task
list-id: AAMkAGI2...
title: Complete quarterly report
due-date: 2024-03-25
importance: high

Response:

{
  "id": "CCMkAGI4...",
  "title": "Complete quarterly report",
  "importance": "high",
  "status": "notStarted",
  "dueDateTime": {
    "dateTime": "2024-03-25T00:00:00",
    "timeZone": "UTC"
  }
}

Download Attachments

Download attachments from an email

Parameters:

  • email-id (required) - ID of the email with attachments

Example:

/your-Microsoft-Outlook-connection
action: download-attachments
email-id: AAMkAGI2...

Response:

{
  "attachments": [
    {
      "name": "report.pdf",
      "contentType": "application/pdf",
      "size": 102400,
      "saved": true
    }
  ]
}

Notes

The integration uses Microsoft Graph API through the PinkConnect proxy. Email attachments are accessed through the contentBytes field in attachment metadata. Calendar events use ISO 8601 date/time format. Search queries cannot be combined with ordering operations. Todo lists must be retrieved first to get list IDs for task operations. The connection ID is required for all operations.