A unified MCP server for email orchestration, supporting Gmail and Outlook with standardized metadata, secure credential injection, and agentic email workflows for managing mail through assistants.

Installation

From Source Code

git clone https://github.com/Astroa7m/MailNet-MCP-Server.git
cd MailNet-MCP-Server
pip install -r requirements.txt

UV Run

uv run -m mcp_launcher.server

Python Run

python -m mcp_launcher.server

Configuration

Claude Desktop

{
  "mcpservers": {
    "email_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Path\\To\\mcp-server",
        "run",
        "-m",
        "mcp_launcher.server"
      ],
      "env": {
        "AZURE_APPLICATION_CLIENT_ID": "<AZURE_APPLICATION_CLIENT_ID>",
        "AZURE_CLIENT_SECRET_VALUE": "<AZURE_CLIENT_SECRET_VALUE>",
        "AZURE_PREFERRED_TOKEN_FILE_PATH": "C:\\Path\\To\\azure_token.json",
        "GOOGLE_CREDENTIALS_FILE_PATH": "C:\\Path\\To\\google_credentials.json",
        "GOOGLE_PREFERRED_TOKEN_FILE_PATH": "C:\\Path\\To\\google_token.json"
      }
    }
  }
}

Available Tools

Tool	Description
send_email	Create and send messages
read_email	Retrieve and view messages
create_draft	Prepare messages
send_draft	Finalize and send
search_email	Search mailbox with semantic filters
toggle_label	Change categories/labels
archive_email	Clean up mailbox
reply_email	Reply in conversation context
delete_email	Delete messages
load_email_settings	View current mail settings
update_email_settings	Update mail settings at runtime

Features

• Unified Gmail + Outlook abstraction
• Automatic token refresh and credential management
• Standardized base class for provider extension
• Agentic email settings endpoint (tone, signature, conversation context, etc.)
• Modular toolset: send, read, search, labels, archive, reply, delete, drafts

Environment Variables

Required

• GOOGLE_CREDENTIALS_FILE_PATH - Path to Google credentials JSON file
• GOOGLE_PREFERRED_TOKEN_FILE_PATH - Path to Google token JSON file
• AZURE_APPLICATION_CLIENT_ID - Azure application client ID for Outlook
• AZURE_CLIENT_SECRET_VALUE - Azure client secret for Outlook
• AZURE_PREFERRED_TOKEN_FILE_PATH - Path to Azure token JSON file

Notes

Requires UV installation for Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex". See Azure Authorization Guide and Google Authorization Guide for setting up accounts and tokens. The server is modular and extensible—inherit the base client to add new providers.