MiguelRipoll23/eml-mcp

eml-mcp

MCP server for managing email archives stored as .eml files. Designed to work alongside a pair of Power Automate flows that automatically export Outlook emails to OneDrive as .eml files, giving AI assistants full read and write access to your inbox, sent items, and drafts through a structured set of tools.

Requirements

• Node.js 20+
• A OneDrive folder (synced locally) — inbox/, outbox/, and drafts/ sub-directories are created automatically on first run

Installation

npx eml-mcp /path/to/emails --from=you@example.com

Add to your MCP client

<details> <summary>Claude Code</summary>

claude mcp add eml -- npx -y eml-mcp /path/to/emails --from=you@example.com

</details> <details> <summary>GitHub Copilot</summary>

Add to ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "eml": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/eml-mcp/dist/server.js", "/path/to/emails", "--from=you@example.com"]
    }
  }
}

</details> <details> <summary>Codex CLI</summary>

Add to ~/.codex/config.toml:

[mcp_servers.eml]
command = "npx"
args = ["-y", "eml-mcp", "/path/to/emails", "--from=you@example.com"]

</details>

Arguments

| Argument | Required | Description | |---|---|---| | <email-directory> | Yes | Root directory; inbox/, outbox/, and drafts/ sub-directories must exist inside | | --db-path=<path> | No | SQLite index path (default: ~/.eml-mcp/index.db) | | --from=<address> | No | From address for composed drafts (default: draft@eml-mcp) |

Power Automate — Automatic .eml archiving

Each flow watches one Outlook folder and saves every email as an .eml file to the corresponding OneDrive directory. Set up the inbox flow first, then duplicate it for sent items — the only two values that change are noted in the second section.

<details> <summary>Inbox flow — archive received emails</summary>

Trigger

**When a new email arrives (