OutlookSAFE

A Model Context Protocol (MCP) server that provides access to Microsoft Outlook email functionality, allowing LLMs and other MCP clients to read, search, and manage emails through a standardized interface.

Features

• Folder Management: List available mail folders in your Outlook client
• Email Listing: Retrieve emails from specified time periods
• Email Search: Search emails by contact name, keywords, or phrases with OR operators
• Email Details: View complete email content, including attachments
• Email Composition: Create and send new emails
• Email Replies: Reply to existing emails

Prerequisites

• Windows operating system
• Python 3.10 or later
• Microsoft Outlook installed and configured with an active account
• Claude Desktop or another MCP-compatible client

Installation

1. Clone or download this repository
2. Install required dependencies:

pip install mcp>=1.2.0 pywin32>=305

1. Configure Claude Desktop (or your preferred MCP client) to use this server

Configuration

Claude Desktop Configuration

Add the following to your MCP_client_config.json file:

{
"mcpServers": {
"outlook": {
"command": "python",
"args": ["Your path\\outlook_mcp_server.py"],
"env": {}
}
}
}

Usage

Starting the Server

You can start the server directly:

python outlook_mcp_server.py

Or allow an MCP client like Claude Desktop to start it via the configuration.

Available Tools

The server provides the following tools:

1. list_folders: Lists all available mail folders in Outlook
2. list_recent_emails: Lists email titles from the specified number of days
3. search_emails: Searches emails by contact name or keyword
4. get_email_by_number: Retrieves detailed content of a specific email
5. reply_to_email_by_number: Replies to a specific email
6. compose_email: Creates and sends a new email

Example Workflow

1. Use `list_folders