Outlook MCP Server

by marlonluo2018

23 416 downloads Not rated yet

GitHub

Communication

About

# 🤖 Outlook MCP Server **AI-powered email management for Microsoft Outlook** - Search, compose, organize, and batch forward emails with natural language commands. <div align="center"> ⭐ **This saved you time? [Star us](https://github.com/marlonluo2018/outlook-mcp-server/stargazers) - takes 2 seconds, helps thousands…

Explore

- Local data processing – no email leaves your machine
- Natural language email search and composition
- Batch forwarding of emails to CSV‑defined recipients
- Folder creation, listing, and email movement
- Context‑aware reply drafting with AI assistance
- 100% offline operation without cloud dependencies

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Outlook MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

From the repository

- ✅ Python 3.8+
- ✅ Microsoft Outlook 2016+ (must be running)
- ✅ Windows 10+

Method 1: UVX (Recommended - Auto Dependencies)



git clone https://github.com/marlonluo2018/outlook-mcp-server.git

cd outlook-mcp-server

uvx --with "pywin32>=226" --with-editable "." outlook-mcp-server
Ask your AI assistant: "Show me my recent emails" - if it works, you're ready!
Common Issues & Solutions:
| Problem | Check This | Solution |

|---------|------------|----------|

| "uvx not found" | Is UV installed? | pip install uv then retry |

| "python not found" | Python in PATH? | Use full path like C:\Python39\python.exe |

| "Outlook not running" | Outlook window open? | Start Outlook first, then restart MCP |

| "Permission denied" | Admin rights? | Run terminal as administrator |

| "Module not found" | Dependencies installed? | pip install -r requirements.txt |
Configuration Verification:

bash

python -c "import outlook_mcp_server; print('✅ Server module loaded')"

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "outlook mcp server": {
            "outlook-mcp-server-main": {
                "command": "uvx",
                "args": [
                    "--with",
                    "pywin32>=226",
                    "--with-editable",
                    ".",
                    "outlook-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "outlook-mcp-server-main": {
        "command": "uvx",
        "args": [
            "--with",
            "pywin32>=226",
            "--with-editable",
            ".",
            "outlook-mcp-server"
        ]
    }
}

AI-powered email management for Microsoft Outlook - Search, compose, organize, and batch forward emails with natural language commands.

⭐ This saved you time? Star us - takes 2 seconds, helps thousands of Outlook users find this AI email assistant! ⭐

</div>

🤔 Project Choice: Local vs Cloud Approach

This project uses win32COM which works entirely locally with your Outlook data (more secure), while our new Microsoft Graph MCP Server provides online access to the full Microsoft 365 ecosystem (more features). Choose based on your security and functionality needs.

Why Choose This Project (win32COM)?

- ✅ Local Data Processing: All email operations happen locally on your computer - no data leaves your machine - ✅ Enhanced Security: No cloud authentication or API tokens required - works with your existing Outlook setup - ✅ Offline Capability: Access and manage emails even without internet connection - ✅ Privacy-First: Your email data never touches external servers or cloud services

Why Switch to Microsoft Graph API?

- ✅ Full Microsoft 365 Ecosystem: Access Mail, Calendar, Teams, OneDrive, SharePoint - ✅ Cross-Platform Support: Works on Windows, macOS, Linux, and mobile devices - ✅ Modern Authentication: OAuth 2.0 with device code flow - ✅ Cloud-Scale Performance: No local application dependencies - ✅ Online Access: Works directly with cloud-based Microsoft 365 services

---

🚀 Quick Start (2 Minutes)

What You'll Get

- Smart Email Search: "Find emails about budget approval from last week" - AI Email Writing: Draft replies with context-aware suggestions - Easy Organization: Create folders and move emails with simple commands - Batch Forwarding: Send emails to 100s of recipients in minutes, not hours

🤖 AI Behavior & Workflow

The agent_prompt_template.md defines how the AI assistant behaves when managing emails:
- Purpose: Guide the AI's workflow for email search, summarization, and drafting
- Key Rules: AND logic for searches, 5-by-5 email display, confirmation before sending
- Safety: Built-in constraints ensure user control and prevent unauthorized actions
- How to Use: Copy the template content and use it to configure your AI assistant

See the template for complete behavior guidelines and workflow definitions

Why Choose Outlook MCP Server?

| Feature | Outlook MCP Server | Traditional Outlook | Outlook Add-ins |
|---------|-------------------|-------------------|-----------------|
| AI Email Search | ✅ "Find urgent emails from my boss" | ❌ Manual folder browsing | ⚠️ Basic search only |
| Natural Language | ✅ "Show me budget emails from last week" | ❌ Complex filters needed | ⚠️ Limited keywords |
| Batch Forward 100+ Emails | ✅ 2 minutes with CSV | ❌ 50+ minutes manual | ⚠️ 20+ minutes |
| AI Email Writing | ✅ Context-aware replies | ❌ Manual composition | ⚠️ Basic templates |
| Setup Time | ✅ 2 minutes | ✅ Already installed | ❌ 10-30 minutes |
| Privacy | ✅ 100% local processing | ✅ Local only | ⚠️ Cloud-dependent |
| Cost | ✅ Completely free | ✅ Included | 💰 $5-50/month |
| Learning Curve | ✅ Natural language | ✅ Familiar interface | ⚠️ New interface |

Real-World Impact

Before: "I need to forward this email to 150 team members..."
- Manual: Click Forward → Type each email → Send → 2+ hours wasted
- Traditional Outlook: Create distribution list → Add members → Forward → 30+ minutes

After: "Forward this email to everyone in team.csv"
- Outlook MCP Server: Load CSV → AI forwards to all → 2 minutes total
- Time Saved: 48+ minutes per batch operation!

Requirements

- ✅ Python 3.8+ - ✅ Microsoft Outlook 2016+ (must be running) - ✅ Windows 10+

Installation & Setup

Method 1: UVX (Recommended - Auto Dependencies)
```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

🤔 Project Choice: Local vs Cloud Approach

Why Choose This Project (win32COM)?

Why Switch to Microsoft Graph API?

🚀 Quick Start (2 Minutes)

What You'll Get

🤖 AI Behavior & Workflow

Why Choose Outlook MCP Server?

Real-World Impact

Requirements

Installation & Setup

Videos about Outlook MCP Server

How to Build an Outlook Inbox Manager in n8n (Step-by-Step, No Code)

Explore Outlook Email Management MCP Server in Copilot Studio

Build Outlook Summariser APP using Claude + MCP

More like this

Slack

Inbox Zero

Production-ready MCP integrations for AI applications

whatsapp-mcp