jdickey1/imap-email-mcp

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

11 stars 10 forks 品質 72 トレンド 8MIT

MCP server for Claude Code that provides email capabilities through IMAP/SMTP. Read, search, compose, and manage emails from any IMAP provider.

概要

A Model Context Protocol (MCP) server that provides email capabilities to Claude Code, Claude Desktop, Cursor, and other MCP-compatible AI tools. Connect to any IMAP/SMTP email provider to read, search, compose, and manage emails directly from your AI assistant. Claude Code CLI uses claude mcp add, not config files. If your password contains special shell characters (%, ^, *, $, !, etc.), wrap it in single quotes as shown above. Restart Claude Code after adding an MCP for the new tools to become available. Add new MCP server: - imap-email - command - npx -y imap-email-mcp Then set environment variables in Cursor's MCP settings: Add to your config file: - ~/Library/Application Support/Claude/claude_desktop_config.json - %APPDATA%\Claude\claude_desktop_config.

README

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

IMAP Email MCP Server

Quick Start

Claude Code (CLI)

Important: Claude Code CLI uses claude mcp add, not config files.

claude mcp add imap-email -s user \
  -e [email protected] \
  -e IMAP_PASSWORD='your-app-password' \
  -e IMAP_HOST=imap.example.com \
  -- npx -y imap-email-mcp

Note: If your password contains special shell characters (%, ^, *, $, !, etc.), wrap it in single quotes as shown above.

Note: Restart Claude Code after adding an MCP for the new tools to become available.

Verify with:

claude mcp list
claude mcp get imap-email

Remove with:

claude mcp remove imap-email -s user

Cursor

Add new MCP server:

Name: imap-email
Type: command
Command: npx -y imap-email-mcp

Then set environment variables in Cursor’s MCP settings:

[email protected]
IMAP_PASSWORD=your-app-password
IMAP_HOST=imap.example.com

Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "imap-email": {
      "command": "npx",
      "args": ["-y", "imap-email-mcp"],
      "env": {
        "IMAP_USER": "[email protected]",
        "IMAP_PASSWORD": "your-app-password",
        "IMAP_HOST": "imap.example.com"
      }
    }
  }
}

Features

Read emails - List and read emails from any folder
Search - Search by subject, sender, or body content
Compose - Create and save email drafts
Send - Send emails directly via SMTP
Manage drafts - List, read, update, and delete drafts
Delete emails - Remove unwanted messages
Multi-provider support - Works with Gmail, Outlook, Yahoo, Fastmail, and any standard IMAP provider

Configuration

Required Environment Variables

Variable	Description
`IMAP_USER`	Your email address
`IMAP_PASSWORD`	App password (not your main password!)
`IMAP_HOST`	IMAP server hostname

Optional Environment Variables

Variable	Default	Description
`IMAP_PORT`	`993`	IMAP port
`IMAP_TLS`	`true`	Use TLS
`SMTP_HOST`	Same as IMAP_HOST	SMTP server hostname
`SMTP_PORT`	`465`	SMTP port
`SMTP_SECURE`	`true`	Use secure SMTP

Provider Settings

Provider	IMAP_HOST	SMTP_HOST	Notes
Gmail	`imap.gmail.com`	`smtp.gmail.com`	Create App Password

GitHub で README 全文を見る

インストール

npx -y imap-email-mcp

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

設定

{
  "mcpServers": {
    "imap-email": {
      "command": "npx",
      "args": ["-y", "imap-email-mcp"],
      "env": {
        "IMAP_USER": "[email protected]",
        "IMAP_PASSWORD": "your-app-password",
        "IMAP_HOST": "imap.example.com"
      }
    }
  }
}