Outlook MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Outlook: 17 typed functions through one MCP server. No Outlook API key needed.

Functions
17
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Outlook

An MCP server for Outlook alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/microsoft_outlook
Every site

One MCP server for Outlook and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 7
  • getCalendarEventsReturns calendar events within a specified date range, including title, start/end times, and attendee information.

    Arguments

    NameTypeRequired
    startDatestringYes
    endDatestringYes

    Returns microsoft_outlookCalendarEvent[]

    interface microsoft_outlookCalendarEvent {
      id: string;
      title: string;
      startDateTime: string;
      endDateTime: string;
      attendees?: string[];
      organizer?: string;
      description?: string;
      isAllDay?: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/getCalendarEvents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.getCalendarEvents({ startDate: "2025-01-01", endDate: "2025-01-31" });
  • getContactOpens one contact from listContacts' results and returns the full contact card.

    Arguments

    NameTypeRequired
    contactIdstring | numberYes

    Returns microsoft_outlookContactDetail

    interface microsoft_outlookContactDetail {
      id: string;
      name: string;
      email?: string;
      phone?: string;
      jobTitle?: string;
      companyName?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/getContact

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.getContact("0");
  • getMailOpens one mail item from readMailFolder's results and returns the full message.

    Arguments

    NameTypeRequired
    mailIdstring | numberYes

    Returns microsoft_outlookMailDetail

    interface microsoft_outlookMailDetail {
      id: string;
      subject: string;
      from: string;
      to?: string;
      receivedDateTime: string;
      body: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/getMail

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.getMail("0:0");
  • listContactsLists the signed-in user's contacts from the Outlook people page, with email and phone where present.

    Arguments

    None.

    Returns microsoft_outlookContact[]

    interface microsoft_outlookContact {
      id: string;
      name: string;
      email?: string;
      phone?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/listContacts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.listContacts();
  • listMailFoldersLists the mail folders (Inbox, Sent, Drafts, etc.) available to the signed-in user, with optional unread counts.

    Arguments

    None.

    Returns microsoft_outlookFolder[]

    interface microsoft_outlookFolder {
      id: string;
      name: string;
      unreadCount?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/listMailFolders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.listMailFolders();
  • readMailFolderReads the mail items in a specific folder, returning subject, sender, date, and preview for each message.

    Arguments

    NameTypeRequired
    folderIdstring | numberYes

    Returns microsoft_outlookMailItem[]

    interface microsoft_outlookMailItem {
      id: string;
      subject: string;
      from: string;
      receivedDateTime: string;
      preview?: string;
      isRead?: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/readMailFolder

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.readMailFolder("0");
  • searchMailSearches one folder (defaults to Inbox) for messages matching a text query, returning the same shape as readMailFolder.

    Arguments

    NameTypeRequired
    querystringYes
    folderIdstring | numberNo

    Returns microsoft_outlookMailItem[]

    interface microsoft_outlookMailItem {
      id: string;
      subject: string;
      from: string;
      receivedDateTime: string;
      preview?: string;
      isRead?: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/searchMail

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.searchMail({ query: "test" });
Act 10
  • createCalendarEventCreates a new calendar event with the specified title, start/end times, and optional description and attendees.

    Arguments

    NameTypeRequired
    titlestringYes
    startDateTimestringYes
    endDateTimestringYes
    descriptionstringNo
    isAllDaybooleanNo
    attendeesstring | string[]No

    Returns microsoft_outlookCreateCalendarEventResult

    interface microsoft_outlookCreateCalendarEventResult {
      id: string;
      status: "created" | "created_draft";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/createCalendarEvent

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.createCalendarEvent({
      title: "<title>",
      startDateTime: "<startDateTime>",
      endDateTime: "<endDateTime>"
    });
  • createContactCreates a new contact in the signed-in user's address book with the given name and optional email, phone, job title and company.

    Arguments

    NameTypeRequired
    namestringYes
    emailstringNo
    phonestringNo
    jobTitlestringNo
    companyNamestringNo

    Returns microsoft_outlookCreateContactResult

    interface microsoft_outlookCreateContactResult {
      id: string;
      status: "created" | "created_draft";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/createContact

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.createContact({ name: "<name>" });
  • deleteCalendarEventDeletes one event from the signed-in user's calendar, by its getCalendarEvents index.

    Arguments

    NameTypeRequired
    eventIdstring | numberYes

    Returns microsoft_outlookDeleteCalendarEventResult

    interface microsoft_outlookDeleteCalendarEventResult {
      id: string;
      status: "deleted";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/deleteCalendarEvent

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.deleteCalendarEvent("<eventId>");
  • deleteMailDeletes one message (Outlook moves it to Deleted Items), through Outlook's own Delete action.

    Arguments

    NameTypeRequired
    mailIdstringYes

    Returns microsoft_outlookDeleteMailResult

    interface microsoft_outlookDeleteMailResult {
      id: string;
      status: "deleted";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/deleteMail

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.deleteMail("<mailId>");
  • forwardMailForwards one message to a new recipient with an optional note, through Outlook's own Forward action.

    Arguments

    NameTypeRequired
    mailIdstring | numberYes
    tostringYes
    bodystringNo

    Returns microsoft_outlookSendMailResult

    interface microsoft_outlookSendMailResult {
      id: string;
      status: "sent" | "draft";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/forwardMail

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.forwardMail({ mailId: "<mailId>", to: "<to>" });
  • moveMailMoves one message into a different folder, through Outlook's own Move to action.

    Arguments

    NameTypeRequired
    mailIdstring | numberYes
    targetFolderIdstring | numberYes

    Returns microsoft_outlookMoveMailResult

    interface microsoft_outlookMoveMailResult {
      id: string;
      movedTo: string;
      status: "moved";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/moveMail

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.moveMail({ mailId: "<mailId>", targetFolderId: "<targetFolderId>" });
  • replyToMailReplies to one message within its existing conversation thread, through Outlook's own Reply action.

    Arguments

    NameTypeRequired
    mailIdstring | numberYes
    bodystringYes

    Returns microsoft_outlookSendMailResult

    interface microsoft_outlookSendMailResult {
      id: string;
      status: "sent" | "draft";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/replyToMail

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.replyToMail({ mailId: "<mailId>", body: "<body>" });
  • respondToEventInviteAccepts, tentatively accepts, or declines a calendar invite, by its getCalendarEvents index.

    Arguments

    NameTypeRequired
    eventIdstring | numberYes
    response"accept" | "tentative" | "decline"Yes

    Returns microsoft_outlookRespondToEventInviteResult

    interface microsoft_outlookRespondToEventInviteResult {
      id: string;
      response: "accept" | "tentative" | "decline";
      status: "responded";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/respondToEventInvite

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.respondToEventInvite({ eventId: "<eventId>", response: "accept" });
  • sendMailComposes and sends a new email message to the specified recipient with the given subject and body.

    Arguments

    NameTypeRequired
    tostringYes
    subjectstringYes
    bodystringYes

    Returns microsoft_outlookSendMailResult

    interface microsoft_outlookSendMailResult {
      id: string;
      status: "sent" | "draft";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/sendMail

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.sendMail({ to: "<to>", subject: "<subject>", body: "<body>" });
  • updateCalendarEventUpdates one event on the signed-in user's calendar.

    Arguments

    NameTypeRequired
    eventIdstring | numberYes
    titlestringNo
    startDateTimestringNo
    endDateTimestringNo

    Returns microsoft_outlookUpdateCalendarEventResult

    interface microsoft_outlookUpdateCalendarEventResult {
      id: string;
      status: "updated" | "updated_draft";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/microsoft_outlook/updateCalendarEvent

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.microsoft_outlook.updateCalendarEvent({ eventId: "<eventId>" });

Use it from code