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.
- Site
- outlook.live.com
- Functions
- 17
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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_outlookOne MCP server for Outlook and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth 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.
getCalendarEventsReturns calendar events within a specified date range, including title, start/end times, and attendee information.Arguments
Name Type Required 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/getCalendarEventsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.getCalendarEvents({ startDate: "2025-01-01", endDate: "2025-01-31" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.getCalendarEvents({"startDate": "2025-01-01", "endDate": "2025-01-31"}))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/getCalendarEvents \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"startDate":"2025-01-01","endDate":"2025-01-31"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required contactIdstring | numberYes Returns
microsoft_outlookContactDetailinterface 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/getContactCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.getContact("0");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.getContact("0"))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/getContact \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"contactId":"0"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.microsoft_outlook.getContact("0");getMailOpens one mail item from readMailFolder's results and returns the full message.Arguments
Name Type Required mailIdstring | numberYes Returns
microsoft_outlookMailDetailinterface 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/getMailCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.getMail("0:0");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.getMail("0:0"))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/getMail \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"mailId":"0:0"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listContactsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.listContacts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.listContacts())curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/listContacts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listMailFoldersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.listMailFolders();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.listMailFolders())curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/listMailFolders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.microsoft_outlook.listMailFolders();readMailFolderReads the mail items in a specific folder, returning subject, sender, date, and preview for each message.Arguments
Name Type Required 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/readMailFolderCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.readMailFolder("0");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.readMailFolder("0"))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/readMailFolder \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"folderId":"0"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchMailCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.searchMail({ query: "test" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.searchMail({"query": "test"}))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/searchMail \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"test"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.microsoft_outlook.searchMail({ query: "test" });
createCalendarEventCreates a new calendar event with the specified title, start/end times, and optional description and attendees.Arguments
Name Type Required titlestringYes startDateTimestringYes endDateTimestringYes descriptionstringNo isAllDaybooleanNo attendeesstring | string[]No Returns
microsoft_outlookCreateCalendarEventResultinterface microsoft_outlookCreateCalendarEventResult { id: string; status: "created" | "created_draft"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/microsoft_outlook/createCalendarEventCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.createCalendarEvent({ title: "<title>", startDateTime: "<startDateTime>", endDateTime: "<endDateTime>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.createCalendarEvent({ "title": "<title>", "startDateTime": "<startDateTime>", "endDateTime": "<endDateTime>" }))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/createCalendarEvent \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"title":"<title>","startDateTime":"<startDateTime>","endDateTime":"<endDateTime>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required namestringYes emailstringNo phonestringNo jobTitlestringNo companyNamestringNo Returns
microsoft_outlookCreateContactResultinterface microsoft_outlookCreateContactResult { id: string; status: "created" | "created_draft"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/microsoft_outlook/createContactCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.createContact({ name: "<name>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.createContact({"name": "<name>"}))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/createContact \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"name":"<name>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.microsoft_outlook.createContact({ name: "<name>" });deleteCalendarEventDeletes one event from the signed-in user's calendar, by its getCalendarEvents index.Arguments
Name Type Required eventIdstring | numberYes Returns
microsoft_outlookDeleteCalendarEventResultinterface microsoft_outlookDeleteCalendarEventResult { id: string; status: "deleted"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/microsoft_outlook/deleteCalendarEventCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.deleteCalendarEvent("<eventId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.deleteCalendarEvent("<eventId>"))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/deleteCalendarEvent \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"eventId":"<eventId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.microsoft_outlook.deleteCalendarEvent("<eventId>");deleteMailDeletes one message (Outlook moves it to Deleted Items), through Outlook's own Delete action.Arguments
Name Type Required mailIdstringYes Returns
microsoft_outlookDeleteMailResultinterface microsoft_outlookDeleteMailResult { id: string; status: "deleted"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/microsoft_outlook/deleteMailCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.deleteMail("<mailId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.deleteMail("<mailId>"))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/deleteMail \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"mailId":"<mailId>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required mailIdstring | numberYes tostringYes bodystringNo Returns
microsoft_outlookSendMailResultinterface microsoft_outlookSendMailResult { id: string; status: "sent" | "draft"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/microsoft_outlook/forwardMailCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.forwardMail({ mailId: "<mailId>", to: "<to>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.forwardMail({"mailId": "<mailId>", "to": "<to>"}))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/forwardMail \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"mailId":"<mailId>","to":"<to>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required mailIdstring | numberYes targetFolderIdstring | numberYes Returns
microsoft_outlookMoveMailResultinterface microsoft_outlookMoveMailResult { id: string; movedTo: string; status: "moved"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/microsoft_outlook/moveMailCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.moveMail({ mailId: "<mailId>", targetFolderId: "<targetFolderId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.moveMail({"mailId": "<mailId>", "targetFolderId": "<targetFolderId>"}))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/moveMail \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"mailId":"<mailId>","targetFolderId":"<targetFolderId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required mailIdstring | numberYes bodystringYes Returns
microsoft_outlookSendMailResultinterface microsoft_outlookSendMailResult { id: string; status: "sent" | "draft"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/microsoft_outlook/replyToMailCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.replyToMail({ mailId: "<mailId>", body: "<body>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.replyToMail({"mailId": "<mailId>", "body": "<body>"}))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/replyToMail \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"mailId":"<mailId>","body":"<body>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.microsoft_outlook.replyToMail({ mailId: "<mailId>", body: "<body>" });respondToEventInviteAccepts, tentatively accepts, or declines a calendar invite, by its getCalendarEvents index.Arguments
Name Type Required eventIdstring | numberYes response"accept" | "tentative" | "decline"Yes Returns
microsoft_outlookRespondToEventInviteResultinterface microsoft_outlookRespondToEventInviteResult { id: string; response: "accept" | "tentative" | "decline"; status: "responded"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/microsoft_outlook/respondToEventInviteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.respondToEventInvite({ eventId: "<eventId>", response: "accept" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.respondToEventInvite({"eventId": "<eventId>", "response": "accept"}))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/respondToEventInvite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"eventId":"<eventId>","response":"accept"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required tostringYes subjectstringYes bodystringYes Returns
microsoft_outlookSendMailResultinterface microsoft_outlookSendMailResult { id: string; status: "sent" | "draft"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/microsoft_outlook/sendMailCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.sendMail({ to: "<to>", subject: "<subject>", body: "<body>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.sendMail({"to": "<to>", "subject": "<subject>", "body": "<body>"}))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/sendMail \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"to":"<to>","subject":"<subject>","body":"<body>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.microsoft_outlook.sendMail({ to: "<to>", subject: "<subject>", body: "<body>" });updateCalendarEventUpdates one event on the signed-in user's calendar.Arguments
Name Type Required eventIdstring | numberYes titlestringNo startDateTimestringNo endDateTimestringNo Returns
microsoft_outlookUpdateCalendarEventResultinterface microsoft_outlookUpdateCalendarEventResult { id: string; status: "updated" | "updated_draft"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/microsoft_outlook/updateCalendarEventCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.microsoft_outlook.updateCalendarEvent({ eventId: "<eventId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.microsoft_outlook.updateCalendarEvent({"eventId": "<eventId>"}))curl -X POST https://api.bowmark.ai/v1/sites/microsoft_outlook/updateCalendarEvent \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"eventId":"<eventId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.microsoft_outlook.updateCalendarEvent({ eventId: "<eventId>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/microsoft_outlook/<function> - OpenAPI
/v1/sites/microsoft_outlook/openapi.json