mcp-outlook-applescript
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-outlook-applescript list my unread emails"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-outlook-applescript
A Model Context Protocol server for Microsoft Outlook on Mac. Access your mail, calendar, contacts, tasks, and notes through 49 MCP tools powered by AppleScript.
Features
AppleScript backend — works with classic Outlook for Mac, no network or authentication required
49 tools — full coverage of mail, calendar, contacts, tasks, and notes
Approval system — destructive operations (delete, move, junk) require a two-step prepare/confirm flow
Zero native dependencies — pure TypeScript + AppleScript, no C++ compilation needed
Available Tools
Category | Tools |
| |
Mail Organization |
|
Folders |
|
Calendar |
|
Contacts |
|
Tasks |
|
Notes |
|
Accounts |
|
Related MCP server: mega-outlook-mcp
Install
git clone https://github.com/hasan-imam/mcp-outlook-applescript.git
cd mcp-outlook-applescript
npm install && npm run build && npm pack && npm install -g mcp-outlook-applescript-*.tgz
cd .. && rm -rf mcp-outlook-applescriptThis installs mcp-outlook-applescript as a global command. The checkout can be deleted after install.
To update, re-run the commands above.
Claude Code
claude mcp add outlook -- mcp-outlook-applescriptClaude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"outlook": {
"command": "mcp-outlook-applescript"
}
}
}Requirements
macOS with Microsoft Outlook (classic) installed and running
Node.js >= 20
Automation permission for Outlook (System Settings > Privacy & Security > Automation)
Development
npm install
npm run build # compile TypeScript → dist/
npm run typecheck # type-check without emitting
npm test # 121 unit tests
bash scripts/audit.sh # static quality audit (build, security, package, functional)License
MIT — see LICENSE.
Available Tools
49 toolsclear_email_flagA
Clear the follow-up flag from an email, setting it to "not flagged". This is a convenience shortcut equivalent to set_email_flag with flag_status 0. Returns a success confirmation. Returns an error if the email ID does not exist.
Inputs: email_id (required).
confirm_archive_emailA
Confirm and execute archiving an email using a token from prepare_archive_email. Moves the email to the Archive folder. Returns a success message. Returns an error if the token is invalid, expired, already used, or if the email has changed since the prepare step.
Inputs: email_id (required), token_id (required).
confirm_batch_operationA
Confirm and execute a batch operation using tokens from prepare_batch_delete_emails or prepare_batch_move_emails. You may selectively confirm by including only the desired token/email pairs. Returns per-email results with success/failure status and a summary with total, succeeded, and failed counts. Individual tokens that are invalid, expired, or already used will fail without blocking others.
Inputs: tokens (required).
confirm_delete_emailA
Confirm and execute deletion of an email using a token from prepare_delete_email. Moves the email to the Deleted Items folder. Returns a success message. Returns an error if the token is invalid, expired, already used, or if the email has changed since the prepare step.
Inputs: email_id (required), token_id (required).
confirm_delete_folderA
Confirm and execute deletion of a mail folder using a token from prepare_delete_folder. Permanently deletes the folder and all its messages. Returns a success message. Returns an error if the token is invalid, expired, already used, or if the folder has changed since the prepare step.
Inputs: token_id (required), folder_id (required).
confirm_empty_folderA
Confirm and execute emptying a mail folder using a token from prepare_empty_folder. Deletes all messages in the folder. Returns a success message. Returns an error if the token is invalid, expired, already used, or if the folder has changed since the prepare step.
Inputs: token_id (required), folder_id (required).
confirm_junk_emailA
Confirm and execute marking an email as junk using a token from prepare_junk_email. Moves the email to the Junk folder. Returns a success message. Returns an error if the token is invalid, expired, already used, or if the email has changed since the prepare step.
Inputs: email_id (required), token_id (required).
confirm_move_emailA
Confirm and execute moving an email using a token from prepare_move_email. Moves the email to the destination folder specified during the prepare step. Returns a success message. Returns an error if the token is invalid, expired, already used, or if the email has changed since the prepare step.
Inputs: email_id (required), token_id (required).
create_eventA
Create a new calendar event in Outlook. Use this to schedule meetings or reminders. Returns the created event with id, title, start/end dates, calendar_id, and is_recurring flag. Optionally specify a target calendar_id (from list_calendars), location, description, all-day flag, or recurrence pattern. Returns an error if start_date is not before end_date or if the calendar is unavailable. Use delete_event to remove a created event.
Inputs: title (required), end_date (required), start_date (required), location, +4 more.
create_folderA
Create a new mail folder in Outlook. Creates a top-level folder by default, or a subfolder if parent_folder_id is specified. Returns the created folder with id, name, messageCount, and unreadCount. Use list_folders to discover existing folder IDs for the parent. Returns an error if the parent folder does not exist.
Inputs: name (required), parent_folder_id.
delete_eventA
Delete a calendar event from Outlook. For recurring events, use apply_to to choose between deleting a single instance or the entire series. Returns a confirmation message. This action is permanent and cannot be undone. Returns an error if the event ID does not exist. Use get_event to verify the event before deleting.
Inputs: event_id (required), apply_to.
download_attachmentA
Download and save an email attachment to a file on disk. Use this after list_attachments to get the 1-based attachment index. Returns the saved file path, name, and size in bytes. Writes the file to the specified save_path — the parent directory must already exist. Returns an error if the email or attachment does not exist, the directory is invalid, or the attachment exceeds the size limit.
Inputs: email_id (required), save_path (required), attachment_index (required).
get_contactA
Get full details of a single contact. Use this after list_contacts or search_contacts to see complete information. Returns all summary fields plus firstName, lastName, company, jobTitle, department, emails (with type and address), phones (with type and number), addresses, and notes. Returns an error if the contact ID does not exist.
Inputs: contact_id (required).
get_emailA
Get full details of a single email including its body content. Use this after list_emails or search_emails to read the complete message. Returns all summary fields plus recipients, body (plain text when strip_html is true, the default), attachments list, messageId, and conversationId. Set strip_html to false to also receive the raw HTML in the htmlBody field. Returns an error if the email ID does not exist. Set include_body to false for metadata only.
Inputs: email_id (required), strip_html, include_body.
get_eventA
Get full details of a single calendar event. Use this after list_events or search_events to see the complete event including location, description, organizer, and attendees list. Returns all summary fields plus location, description, organizer, attendees (with name and status), and recurrence IDs. Returns an error if the event ID does not exist.
Inputs: event_id (required).
get_noteA
Get full details of a single note. Use this after list_notes or search_notes to read the complete note content. Returns all summary fields plus body, createdDate, and categories. Returns an error if the note ID does not exist.
Inputs: note_id (required).
get_taskA
Get full details of a single task. Use this after list_tasks or search_tasks to see the complete task. Returns all summary fields plus startDate, completedDate, body, hasReminder, reminderDate, and categories. Returns an error if the task ID does not exist.
Inputs: task_id (required).
get_unread_countA
Get the count of unread emails, either across all folders or for a specific folder. Use this for a quick check without fetching full email lists. Returns an object with a single "count" field (number). Optionally pass folder_id to limit the count to a specific folder (get folder IDs from list_folders). Requires Outlook to be running.
Inputs: folder_id.
list_accountsA
List all mail accounts configured in Microsoft Outlook for Mac. Use this to discover account IDs needed by other tools (e.g., list_folders with account_id filter). Returns an array of accounts, each with id, name, email, and type fields. Note: only Exchange, IMAP, and POP account types are returned; newer Microsoft 365 account types may not appear. Requires Outlook to be running or returns an error.
Inputs: no named parameters.
list_attachmentsA
List attachment metadata for a specific email. Use this before download_attachment to discover attachment indices and sizes. Returns an array of attachment objects with index, name, size (bytes), and contentType. Returns an error if the email ID does not exist. Returns an empty array if the email has no attachments.
Inputs: email_id (required).
list_calendarsA
List all calendar folders configured in Outlook. Use this to discover calendar IDs for filtering in list_events or specifying a target calendar in create_event. Returns an array of calendar objects with id, name, and accountId. Requires Outlook to be running or returns an error.
Inputs: no named parameters.
list_contactsA
List contact summaries from Outlook with pagination. Returns {items, count, hasMore} — increment offset by limit when hasMore is true. For full details including emails, phones, and addresses, use get_contact. Use search_contacts to find contacts by name.
Inputs: limit, offset.
list_emailsA
List email summaries in a specific mail folder, ordered newest first. Each result includes a 500-char body preview for browsing without needing get_email. Returns {items, count, hasMore} — when hasMore is true, increment offset by limit to fetch the next page. Use after/before (ISO 8601) to filter by received date. For full email content, use get_email. Requires Outlook to be running.
Inputs: folder_id (required), after, limit, before, +2 more.
list_eventsA
List calendar events with optional date range or calendar filtering. Returns {items, count, hasMore} — increment offset by limit when hasMore is true. Filter by date range (start_date + end_date in ISO 8601) and/or calendar_id (from list_calendars). Use get_event for full details including attendees and description.
Inputs: limit, offset, end_date, start_date, +1 more.
list_foldersA
List all mail folders in Outlook with their message and unread counts. Use this to discover folder IDs needed by list_emails, search_emails, prepare_move_email, and other folder-based tools. Returns an array of folders, each with id, name, messageCount, and unreadCount. When account_id is provided, returns folders grouped by account. Returns an error if Outlook is not running.
Inputs: account_id.
list_notesA
List note summaries from Outlook with pagination. Returns {items, count, hasMore} — increment offset by limit when hasMore is true. For full details including body content, use get_note. Use search_notes to find notes by title.
Inputs: limit, offset.
list_tasksA
List task summaries from Outlook with pagination and optional completion filtering. Returns {items, count, hasMore} — increment offset by limit when hasMore is true. Set include_completed to false to see only incomplete tasks. For full details including body and reminder, use get_task.
Inputs: limit, offset, include_completed.
mark_email_readA
Mark an email as read in Outlook. Use this to clear unread indicators on a message. Returns a success confirmation. Returns an error if the email ID does not exist. Use mark_email_unread to reverse this action.
Inputs: email_id (required).
mark_email_unreadA
Mark an email as unread in Outlook. Use this to restore the unread indicator on a message. Returns a success confirmation. Returns an error if the email ID does not exist. Use mark_email_read to reverse this action.
Inputs: email_id (required).
move_folderA
Move a mail folder under a different parent folder in Outlook. Relocates the folder and all its contents to the new parent. Returns a success confirmation. Returns an error if either the source or destination folder ID does not exist. Use list_folders to find folder IDs.
Inputs: folder_id (required), destination_parent_id (required).
prepare_archive_emailA
Prepare to archive an email (move to Archive folder). Returns a preview of the email and an approval token. Call confirm_archive_email with the token to execute. Returns an error if the email ID does not exist. The token expires after 5 minutes.
Inputs: email_id (required).
prepare_batch_delete_emailsA
Prepare to delete multiple emails (up to 50). Returns individual approval tokens per email so you can selectively confirm. Call confirm_batch_operation with the desired tokens to execute. Returns an error if any email ID does not exist. Tokens expire after 5 minutes.
Inputs: email_ids (required).
prepare_batch_move_emailsA
Prepare to move multiple emails (up to 50) to a destination folder. Returns individual approval tokens per email so you can selectively confirm. Call confirm_batch_operation with the desired tokens to execute. Returns an error if any email or the destination folder ID does not exist. Tokens expire after 5 minutes.
Inputs: email_ids (required), destination_folder_id (required).
prepare_delete_emailA
Prepare to delete an email (move to trash). Returns a preview of the email and an approval token with expiration time. Call confirm_delete_email with the token to execute the deletion. Returns an error if the email ID does not exist. The token expires after 5 minutes.
Inputs: email_id (required).
prepare_delete_folderA
Prepare to delete a mail folder and all its messages. Returns a preview of the folder (with message count) and an approval token. Call confirm_delete_folder with the token to execute. Returns an error if the folder ID does not exist. The token expires after 5 minutes.
Inputs: folder_id (required).
prepare_empty_folderA
Prepare to empty a mail folder by deleting all its messages. Returns a preview of the folder (with message count) and an approval token. Call confirm_empty_folder with the token to execute. Returns an error if the folder ID does not exist. The token expires after 5 minutes.
Inputs: folder_id (required).
prepare_junk_emailA
Prepare to mark an email as junk (move to Junk folder). Returns a preview of the email and an approval token. Call confirm_junk_email with the token to execute. Returns an error if the email ID does not exist. The token expires after 5 minutes.
Inputs: email_id (required).
prepare_move_emailA
Prepare to move an email to another folder. Returns a preview of the email, destination folder details, and an approval token. Call confirm_move_email with the token to execute the move. Returns an error if the email or destination folder ID does not exist. The token expires after 5 minutes.
Inputs: email_id (required), destination_folder_id (required).
rename_folderA
Rename a mail folder in Outlook. Changes the display name of the folder without moving it. Returns a success confirmation with the new name. Returns an error if the folder ID does not exist. Use list_folders to find folder IDs.
Inputs: new_name (required), folder_id (required).
respond_to_eventA
Respond to a meeting invitation with accept, decline, or tentative. Updates your RSVP status in Outlook and by default sends a response notification to the organizer (set send_response to false to suppress). Returns a confirmation message. Use get_event first to review the event details before responding. Returns an error if the event ID does not exist or event response is unavailable.
Inputs: event_id (required), response (required), comment, send_response.
search_contactsA
Search contacts by matching the query against contact names. Returns {items, count, hasMore} — increment offset by limit when hasMore is true. For full contact details, call get_contact on a matching ID.
Inputs: query (required), limit, offset.
search_emailsA
Search emails by matching the query against subject line and sender address. Returns metadata only (subject, sender, date, flags) — no body preview. For email content, call get_email on a matching ID. Returns {items, count, hasMore} — increment offset by limit when hasMore is true. Use after/before (ISO 8601) to filter by received date. Use folder_id to scope to one folder. Pagination is fast at any offset.
Inputs: query (required), after, limit, before, +2 more.
search_eventsA
Search calendar events by matching the query against event titles. Returns {items, count, hasMore} — increment offset by limit when hasMore is true. Use after/before (ISO 8601) to filter by event start date. For full event details including attendees, call get_event on a matching ID.
Inputs: query (required), after, limit, before, +1 more.
search_notesA
Search notes by matching the query against note titles/names only (does not search body content). Returns {items, count, hasMore} — increment offset by limit when hasMore is true. For full note content, call get_note on a matching ID.
Inputs: query (required), limit, offset.
search_tasksA
Search tasks by matching the query against task names. Returns {items, count, hasMore} — increment offset by limit when hasMore is true. For full task details, call get_task on a matching ID.
Inputs: query (required), limit, offset.
send_emailA
Send an email from Outlook with optional CC, BCC, file attachments, inline images, and HTML formatting. This action sends the email immediately and cannot be undone. Returns the sent message_id and sent_at timestamp. Use list_accounts to find account_id if sending from a non-default account. Returns an error if required fields (to, subject) are missing or if attachment file paths do not exist.
Inputs: to (required), body (required), subject (required), cc, +6 more.
set_email_categoriesA
Set categories on an email, replacing any existing categories. Use this to organize emails with color-coded labels. Pass an empty array to clear all categories. Returns a success confirmation. Returns an error if the email ID does not exist. Use get_email to check current categories before modifying.
Inputs: email_id (required), categories (required).
set_email_flagA
Set the follow-up flag status on an email. Use flag_status 1 for flagged, 2 for completed, or 0 to clear. Returns a success confirmation. For a simpler clear-only operation, use clear_email_flag instead. Returns an error if the email ID does not exist.
Inputs: email_id (required), flag_status (required).
update_eventA
Update a calendar event in Outlook. Only the fields you specify will be changed — omitted fields remain unchanged. For recurring events, use apply_to to choose between updating a single instance or the entire series. Returns a confirmation with the event ID and list of updated field names. Returns an error if the event ID does not exist or start_date is not before end_date. Use get_event to review current values before updating.
Inputs: event_id (required), title, apply_to, end_date, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 49 tools
Each tool targets a distinct resource and action; the prepare/confirm pairs are clearly differentiated by action and resource, and confirm_batch_operation explicitly states which prepare tools it consumes. Even similarly named tools like list_emails/search_emails or set_email_flag/clear_email_flag have non-overlapping purposes described clearly.
The surface uses a consistent snake_case verb_noun pattern (list_*, get_*, search_*, create_*, update_*, delete_*, prepare_*, confirm_*), which makes navigation predictable. Minor inconsistencies exist: singular vs plural resources (email vs emails), and confirm_batch_operation is generic where a verb_noun name would fit better.
At 49 tools, the surface is heavily over-scoped for an agent to navigate. The 16 prepare/confirm pairs plus batch variants inflate the count significantly; many could be consolidated into a single tool with an optional confirmation step.
Mail, folders, and calendar events have solid CRUD/lifecycle coverage, but contacts, tasks, and notes are read-only (list/search/get only), and create_event/update_event omit attendee management. These are notable gaps that will block common Outlook workflows, though core email operations are complete.
Maintenance
Related MCP Connectors
A MCP server that works with Outlook Calendar to manage event listing, reading, and updates.
A MCP server for Outlook email that lets you search, read, and draft emails and replies.
Hosted MCP server for your Gmail, Outlook and IMAP mail, with mailboxes and scopes set per agent.
Your IMAP mailbox as an MCP server: read, search and (if you allow it) organize mail. Open source.
Related MCP Servers
- AlicenseBqualityAmaintenanceMCP server that provides 62 tools to manage Outlook mail, calendar, contacts, and tasks for personal Microsoft accounts via Microsoft Graph API.71995 PyPI45MIT
- AlicenseNot gradedqualityDmaintenanceComprehensive MCP server for local Microsoft Outlook automation, providing 64 tools across email, calendar, contacts, tasks, notes, and Exchange features on both Windows and macOS.15 PyPI1MIT
- AlicenseNot gradedqualityBmaintenanceTurns your running Outlook Desktop into an MCP server, enabling email, calendar, tasks, and attachment management through your existing Outlook session without any cloud APIs.AGPL 3.0
- AlicenseNot gradedqualityDmaintenanceMCP server for Microsoft Outlook that enables searching, sending, and managing mail and calendar via the OWA REST API using browser-session authentication, with no Azure AD app registration required.MIT