florianbuetow/imap-mini-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

11 stars 7 forks 품질 72 트렌드 32

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"
      }
    }
  }
}