list_recent_emails_toolLABSCO SUMMARY
Mail work through the Outlook already on your desk.
Nothing leaves the machine and no tokens are issued — it uses the session Outlook already holds, which is what makes it usable against a corporate mailbox where cloud API access is not yours to grant.
What it is
An Outlook connector that talks to the desktop application over win32COM rather than to a cloud API. Mail is loaded into a local cache, numbered, and then acted on by number: read one in full, reply to it, move it, or forward a message to a list of recipients from a CSV file.
What you get
- Loading and searching —
list_recent_emails_toolfor a day range up to 30 days,search_email_by_subject_tool,search_email_by_sender_name_tool, andsearch_email_by_body_toolfor content, which is slower - Reading and replying —
view_email_cache_toolpages the loaded mail 5 at a time,get_email_by_number_toolreturns one in full,reply_to_email_by_number_toolanswers it,compose_email_toolwrites a new one - Folders —
get_folder_list_toolfirst, thencreate_folder_tool,move_email_toolandmove_folder_tool - Batch forwarding from a CSV of addresses, as the README describes it: split at 500 per batch and sent by BCC, with your note above the original message. Its tool is not among the 12 the README names
Requirements
Windows 10+ with Microsoft Outlook 2016 or newer installed and running — the server drives the open application, so start Outlook first. Python 3.8+; install with uvx --with "pywin32>=226" or clone and pip install -r requirements.txt, then point the client at python -m outlook_mcp_server. Because operations address mail by its cache number, load a batch before acting on it, and call the folder list before moving anything. The repository ships an agent prompt template that sets the confirm-before-sending behaviour; without it, that safeguard is only as good as your own instructions.
Setup effort
Build from source — git clone https://github.com/marlonluo2018/outlook-mcp-server.git
USE CASES
01
Finding out what arrived while you were away
Load the last few days, page through the cache, and get a one-line summary of each with what needs an answer.
02
Answering a thread with the context intact
Pull the message in full by number, then reply to that number so the draft is written against what was actually said.
03
Sending one message to a long list
The README describes forwarding to a CSV of addresses, split at 500 per batch and sent by BCC. The tool that does it is not among the 12 it names, so check what your client lists.
04
Filing a backlog into folders
Read the folder list first, create what is missing, then move messages by their cache number.
05
Tracking down a message by what it said
Search subjects and senders first; fall back to the body search when only the wording is remembered, accepting that it is slower.
12 tools
Listed in project docs. Your client may show a different list.
search_email_by_subject_toolsearch_email_by_sender_name_toolsearch_email_by_body_toolview_email_cache_toolget_email_by_number_toolreply_to_email_by_number_toolcompose_email_toolget_folder_list_toolcreate_folder_toolmove_email_toolmove_folder_toolBEFORE YOU INSTALL
What to know first
Tools you get
12 tools named in the project's documentation.
Requires
- Windows 10 or later, with Microsoft Outlook 2016 or newer installed and running
- uvx on PATH for the uvx configuration; Python with pip for the direct-source one
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-serverMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"outlook": {
"command": "uvx",
"args": [
"--with",
"pywin32>=226",
"--with-editable",
"<YOUR_PATH_TO_OUTLOOK_MCP_SERVER>",
"outlook-mcp-server"
]
}
}
}<YOUR_PATH_TO_OUTLOOK_MCP_SERVER> is the full path of the folder you cloned. The README's block writes "." there, which means the folder the command starts in — a client does not start inside your clone, so it needs the full path.
Any MCP client — Python
ANY MCP CLIENT — PYTHON · TERMINAL
pip install -r requirements.txtANY MCP CLIENT — PYTHON · JSON
{
"mcpServers": {
"outlook": {
"command": "python",
"args": [
"C:\\Project\\outlook-mcp-server\\outlook_mcp_server\\__main__.py"
]
}
}
}Run pip install -r requirements.txt inside the clone first. C:\Project\outlook-mcp-server is the README's example; yours is the full path of your clone.
