jdickey1/imap-email-mcp

本页由 AI 翻译，技术细节请以原文为准。查看原文

11 stars 10 forks 质量 72 趋势 18MIT

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

新手？先看 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"
      }
    }
  }
}