florianbuetow/imap-mini-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

11 stars 7 forks 品質 72 トレンド 22

Repository Install

A lightweight MCP server for reading IMAP email and creating draft replies. Built for ProtonMail Bridge.

概要

A lightweight MCP (Model Context Protocol) server for reading IMAP email and creating draft replies. Works with any standard IMAP server (Gmail, Outlook, Fastmail, etc.) and local bridges like ProtonMail Bridge. Agents can read, search, move, star, and organize emails, and compose drafts — but cannot send or delete emails. See CHANGELOG.md for recently added features. I highly recommend using a speech-to-text tool (e.g. SuperWhisper on Mac or Whisperflow on Windows) and connecting your AI desktop application (Claude, Codex, etc.) to this MCP server. That way you can converse with your email inbox using speech, which will dramatically speed up your workflow. Add to your MCP client config (e.g. claude_desktop_config.json): The args path must point to the built dist/index.js. Add any optional variables to the env block as needed. For most providers (Gmail, Outlook, Fastmail), the defaults work — just set host, user, and password.

README

以下は原文 README の抜粋です。原文を見る。

IMAP Mini MCP

Agents can read, search, move, star, and organize emails, and compose drafts — but cannot send or delete emails.

See CHANGELOG.md for recently added features.

Workflow Recommendation

I highly recommend using a speech-to-text tool (e.g. SuperWhisper on Mac or Whisperflow on Windows) and connecting your AI desktop application (Claude, Codex, etc.) to this MCP server. That way you can converse with your email inbox using speech, which will dramatically speed up your workflow.

How to Use

Agent configuration

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "imap-mini-mcp": {
      "command": "node",
      "args": ["/path/to/imap-mini-mcp/dist/index.js"],
      "env": {
        "IMAP_HOST": "imap.example.com",
        "IMAP_USER": "[email protected]",
        "IMAP_PASS": "your-password"
      }
    }
  }
}

The args path must point to the built dist/index.js. Add any optional variables to the env block as needed.

Environment variables

Variable	Required	Default	Description
`IMAP_HOST`	yes	—	IMAP server hostname (e.g. `imap.gmail.com`)
`IMAP_USER`	yes	—	Email address or username
`IMAP_PASS`	yes	—	Password or app-specific password
`IMAP_PORT`	no	`993`	IMAP server port
`IMAP_SECURE`	no	`true`	Use TLS for the connection
`IMAP_STARTTLS`	no	`true`	Upgrade to TLS via STARTTLS (when `IMAP_SECURE=false`)
`IMAP_TLS_REJECT_UNAUTHORIZED`	no	`true`	Reject self-signed TLS certificates

For most providers (Gmail, Outlook, Fastmail), the defaults work — just set host, user, and password.

For ProtonMail Bridge — all five settings below are required (the bridge listens on localhost without TLS, uses a self-signed certificate, and does not support STARTTLS):

IMAP_HOST=127.0.0.1
IMAP_PORT=1143
IMAP_SECURE=false
IMAP_STARTTLS=false
IMAP_TLS_REJECT_UNAUTHORIZED=false

Or as MCP client config:

{
  "mcpServers": {
    "imap-mini-mcp": {
      "command": "node",
      "args": ["/path/to/imap-mini-mcp/dist/index.js"],
      "env": {
        "IMAP_HOST": "127.0.0.1",
        "IMAP_PORT": "1143",
        "IMAP_SECURE": "false",
        "IMAP_STARTTLS": "false",
        "IMAP_TLS_REJECT_UNAUTHORIZED": "false",
        "IMAP_USER": "[email protected]",
        "IMAP_PASS": "your-bridge-password"
      }
    }
  }
}

Tools

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "imap-mini-mcp": {
      "command": "node",
      "args": ["/path/to/imap-mini-mcp/dist/index.js"],
      "env": {
        "IMAP_HOST": "imap.example.com",
        "IMAP_USER": "[email protected]",
        "IMAP_PASS": "your-password"
      }
    }
  }
}