outlook

The Outlook MCP Server provides AI-powered email management locally on your Windows machine using win32 COM to interact with Microsoft Outlook. It offers smart email search, AI-assisted composition, reply drafting, folder management, and batch forwarding from CSV lists. You can run it either via UVX (recommended for auto dependency handling) or as a standard Python module. Once the server is running, you configure your MCP client to point at the server using the provided JSON configuration, enabling you to issue natural language commands to search your inbox, draft responses with context, organize messages into folders, and forward large batches efficiently.

Prerequisites:

• Python 3.8+ (Windows) and a running Outlook 2016+ instance
• Optional: uvx (for automatic dependency management)

Method 1 — UVX (Recommended):

# 1. Clone the repository
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server

# 2. Install via UVX with required Windows dependencies
uvx --with "pywin32>=226" --with-editable "." outlook-mcp-server

# 3. Configure your MCP client to use this server:
# Example in MCP client config:
{
  "mcpServers": {
    "outlook": {
      "command": "uvx",
      "args": ["--with", "pywin32>=226", "--with-editable", ".", "outlook-mcp-server"]
    }
  }
}

Method 2 — Standard Python:

# 1. Clone the repository
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server

# 2. Install dependencies and run the server module
pip install -r requirements.txt
python -m outlook_mcp_server

# 3. Configure your MCP client to use this server:
# Example in MCP client config:
{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["-m", "outlook_mcp_server"]
    }
  }
}

Method 3 — Direct Source (Development):

# 1. Clone the repository
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server

# 2. Install dependencies
pip install -r requirements.txt

# 3. Run or point MCP at the development entrypoint with an explicit path if needed
# Example in MCP client config:
{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["C:\\Project\\outlook-mcp-server\\outlook_mcp_server\\__main__.py"]
    }
  }
}

Testing:

• After starting, test with a simple prompt like: "Show me my recent emails" to verify Outlook connectivity and basic functionality.

Prerequisites recap:

• Windows 10+, Outlook running
• Python 3.8+ installed and accessible
• If using UVX, ensure pywin32>=226 is available

Tips:

• If you encounter 'uvx not found', install UVX or use the Python execution method.
• Ensure Outlook is running before starting the MCP server for best connectivity.
• For local-only setups, prefer the win32COM path to avoid cloud tokens.
• If permissions issues arise, run the terminal as Administrator when starting the server.
• You can test Outlook connectivity via: python -c "import win32com.client; outlook = win32com.client.Dispatch('Outlook.Application'); print('✅ Outlook connected')"