@lnwebworks/outlook-mcp-server
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., "@@lnwebworks/outlook-mcp-server Find any unread emails in my inbox from the last 24 hours."
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.
@lnwebworks/outlook-mcp-server
An MCP (Model Context Protocol) server that connects Claude (or any MCP-compatible client) to Outlook via the Microsoft Graph API, using client-credentials (app-only) auth.
Installation
npm install -g @lnwebworks/outlook-mcp-serverOr run directly with npx:
npx @lnwebworks/outlook-mcp-serverRelated MCP server: Outlook MCP Server
Configuration
Copy .env.example to .env and fill in your Azure AD app registration details:
cp .env.example .envRequired:
AZURE_TENANT_IDAZURE_CLIENT_IDAZURE_CLIENT_SECRETOUTLOOK_USER_EMAIL— the mailbox this server acts on by default
Optional:
OUTLOOK_EXCLUDED_FOLDER_IDSOUTLOOK_SKIP_EXCLUDED_FOLDERSOUTLOOK_SIGNOFF_NAME
Usage with an MCP client
Add this server to your MCP client's config, e.g.:
{
"mcpServers": {
"outlook": {
"command": "npx",
"args": ["-y", "@lnwebworks/outlook-mcp-server"],
"env": {
"AZURE_TENANT_ID": "...",
"AZURE_CLIENT_ID": "...",
"AZURE_CLIENT_SECRET": "...",
"OUTLOOK_USER_EMAIL": "..."
}
}
}
}License
MIT
Available Tools
22 toolscancel_calendar_eventA
Cancel a calendar event and notify attendees
Inputs: eventId (required), comment, mailbox.
create_calendar_eventA
Create a new calendar event. Requires approval. Automatically checks for conflicting events in that time range first and refuses (returning conflict:true and the conflicting events) unless force:true is passed — only pass force:true after the user has explicitly approved double-booking.
Inputs: endTime (required), subject (required), startTime (required), body, +5 more.
create_email_draftA
Create a standalone draft email in Outlook Drafts folder for review before sending. Supports file attachments up to 25MB combined.
Inputs: to (required), body (required), subject (required), cc, +4 more.
create_reply_draftA
Create an unsent draft reply attached to an existing email thread using Microsoft Graph createReply API (POST /messages/{id}/createReply). Supports file attachments up to 25MB combined.
Inputs: messageId (required), cc, bcc, body, +3 more.
get_calendar_eventsA
Get calendar events between two datetimes
Inputs: endTime (required), startTime (required), mailbox.
get_conversation_threadB
Retrieve full email conversation history by conversation ID
Inputs: conversationId (required), limit, mailbox.
get_email_attachmentsA
Fetches the content of all the file attachments for a given Outlook messageId. Returns array [{id, name, contentType, size, isInline, contentBytes}].
Inputs: id (required), mailbox.
get_email_foldersA
List all Outlook mail folders with unread counts
Inputs: mailbox.
get_recent_emailsC
Fetch recently received emails from Outlook inbox
Inputs: limit, mailbox.
get_recent_emails_all_foldersA
Fetch recently received emails across the entire mailbox (all folders, not just Inbox), excluding Deleted Items (and its subfolders), Junk, Junk Emails, and Drafts. Returns bodyPreview (short text snippet) instead of full HTML body to keep payload small.
Inputs: limit, mailbox.
get_sent_emailsA
Fetch sent emails to track outbox and detect missing replies
Inputs: limit, mailbox.
get_todays_briefingB
Get today's unread emails and calendar events in one call
Inputs: mailbox.
get_unread_emailsB
Fetch all unread emails from Outlook inbox for triage
Inputs: mailbox.
get_upcoming_eventsC
Get upcoming calendar events for the next N days
Inputs: days, mailbox.
mark_email_readC
Mark an email as read or unread
Inputs: emailId (required), isRead, mailbox.
move_emailC
Move an email to a specific folder
Inputs: emailId (required), destinationFolderId (required), mailbox.
reply_to_emailA
Reply to an existing email thread. Requires prior approval. Supports file attachments up to 25MB combined (over 3MB sends via an internal draft-then-send step — same result, no different usage).
Inputs: body (required), emailId (required), cc, bcc, +3 more.
search_emailsB
Search emails by keyword, sender, subject or topic
Inputs: query (required), limit, mailbox.
send_emailA
Send an approved email. Requires explicit approval from the client first. Supports file attachments up to 25MB combined (over 3MB sends via an internal draft-then-send step — same result, no different usage).
Inputs: to (required), body (required), subject (required), cc, +3 more.
triage_emailC
Classify an email for urgency, category and suggest a reply
Inputs: id (required), body (required), sender (required), subject (required), +1 more.
update_calendar_eventA
Update an existing calendar event. If both startTime and endTime are being changed, automatically checks for conflicting events in the new time range first and refuses (returning conflict:true and the conflicting events) unless force:true is passed — only pass force:true after the user has explicitly approved double-booking.
Inputs: eventId (required), body, force, endTime, +5 more.
update_email_draftA
Update/edit an existing email draft subject, body, or recipient before sending (PATCH /messages/{draftId})
Inputs: draftId (required), cc, to, bcc, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
There is a cluster of email retrieval tools—get_recent_emails, get_recent_emails_all_folders, get_unread_emails, and get_todays_briefing—that overlap in function and could lead an agent to pick the wrong one by name alone. Most other tools are clearly separated by resource/action, and the descriptions resolve the ambiguity if read carefully.
All tools use snake_case verb_noun names (get_, create_, update_, cancel_, send_, reply_to_, move_, mark_) with no camelCase or inconsistent style. Even phrase-based names like get_todays_briefing still follow the get_<thing> convention, so the pattern is predictable.
22 tools is on the heavy side for a mail/calendar server, and the four overlapping email-fetch variants add redundancy rather than distinct capabilities. A tighter set closer to 15-16 tools would be easier to navigate, though the count is not extreme.
Email covers fetch, search, triage, drafts, replies, send, move, mark-read, and attachments; calendar covers create/read/update/cancel with conflict checks. The main gaps are no email deletion or forwarding and no direct send for an existing draft, but agents can work around these.
Related MCP Connectors
Manage Microsoft 365 email, calendar, contacts and inbox rules via the Graph API with OAuth 2.0.
Permissioned access to Outlook, OneDrive and Teams via the user's own Microsoft account
Hosted MCP server for your Gmail, Outlook and IMAP mail, with mailboxes and scopes set per agent.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables to manage your Outlook mailbox via Microsoft Graph (write access) with delegated permissions, providing MCP tools to create, modify, and send emails, folders, categories, rules, and automatic replies.-
- AlicenseNot gradedqualityDmaintenanceEnables reading, sending, and managing Microsoft 365/Outlook emails through MCP tools with OAuth 2.1 authentication.89 npmMIT
- FlicenseNot gradedqualityDmaintenanceMCP server that uses Microsoft Entra OAuth 2.0 On-Behalf-Of flow to access Microsoft Graph for Outlook data, enabling email, calendar, and contacts interactions via MCP tools.-
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to manage a personal Outlook consumer inbox and calendar through Microsoft Graph, with local device-code authentication and OS keyring token storage.20 npmAGPL 3.0