mcp-imap

MCP地图位置

提供方 jlentink

地图位置 stdio · 本地进程 未标注 社区 / 第三方 Claude DesktopClaude
查看接入方式

mcp-imap is an MCP server that provides email reading, sending, searching, and management capabilities to AI assistants via IMAP/SMTP protocols, suitable for scenarios where AI needs to access and operate email.

一句话选型结论

按资料字段整理

mcp-imap 属于地图位置类 MCP 服务器,stdio · 本地进程,鉴权方式未标注,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类地图位置 传输方式stdio · 本地进程 鉴权未标注 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

地图位置
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

Local Deployment Email Service IMAP Go SMTP MCP Server Email Search Email Sending Multi-Account Management AI Integration

支持客户端

适用场景

Local DeploymentEmail ServiceIMAP

安装与配置

stdio · 本地进程 未标注
客户端在本机拉起子进程,数据不出本机
/usr/local/bin/mcp-imap

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 go,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
地址与路线

查地址、算路线、找附近地点。

位置检索

按区域筛门店、站点与设施。

地理数据

拉取经纬度、行政区等地理信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在地图位置场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
mcp-imap当前 未标注 stdio · 本地进程 本地部署 有 2026-03-30
MCP Server C2f246e3 20 stdio · 本地进程 本地部署 有 2026-05-17
OpenStreetMap MCP Server 12 stdio · 本地进程 本地部署 有 2026-05-18
Baidu Maps 10 stdio · 本地进程 本地部署 有 2026-05-17
Google Maps (google-maps-aa2563d3) 7 未标注 未标注 无 2026-05-17
generative-ai 未标注 stdio · 本地进程 本地部署 有 2026-04-17

服务器档案

地图位置
字段来自项目仓库与公开索引,中文说明由本站标注
提供方jlentink上游标注的维护方 jlentink
分类地图位置本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · go本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-03-30上游最后核验时间

详细介绍

6.7 KB
来自项目仓库与上游目录的原文,未做删改

mcp-imap

An MCP (Model Context Protocol) server that exposes IMAP email operations as tools for AI assistants like Claude. Supports multiple accounts, Dovecot-optimised, and ships with a web UI for configuration.

Features

  • Multiple accounts — configure as many IMAP/SMTP accounts as needed
  • Read & manage email — list, get, move, archive, delete, flag
  • Send email — compose, reply (with correct threading headers), reply-all
  • Mailbox browsing — list all folders with message counts
  • Search — full IMAP search by subject, sender, recipient, body text, date range, or flag
  • Filters — unread-only, flagged-only, or all
  • Hot reload — config changes are picked up without restarting
  • Config UI — built-in web interface to manage accounts
  • Transports — stdio (for Claude Desktop) and Streamable HTTP

Installation

Download a release

Download the latest binary for your platform from the Releases page and place it somewhere on your $PATH, e.g.:```bash

macOS (Apple Silicon)

curl -L https://github.com/user/mcp-imap/releases/latest/download/mcp-imap_Darwin_arm64.tar.gz | tar xz
mv mcp-imap /usr/local/bin/


### Build from source

Requires Go 1.22+.```bash
git clone https://github.com/user/mcp-imap.git
cd mcp-imap
just build          # binary written to ./dist/mcp-imap

Configuration

The config file lives at ~/.config/mcp-imap/config.toml.

Using the config UI

The easiest way to configure accounts is through the built-in web interface:```bash
mcp-imap --ui

Config UI available at http://localhost:3456


Open http://localhost:3456 in your browser, add your accounts, and click **Save Config**. The UI will test the connection before saving.

### Manual configuration

Create `~/.config/mcp-imap/config.toml`:```toml
[[accounts]]
name = "personal"
archive_folder = "Archive"   # optional, default: "Archive"

[accounts.imap]
host     = "mail.example.com"
port     = 993
username = "you@example.com"
password = "your-password"
tls      = true

[accounts.smtp]
host     = "mail.example.com"
port     = 587
username = "you@example.com"
password = "your-password"
tls      = false
starttls = true

[[accounts]]
name = "work"

[accounts.imap]
host     = "imap.company.com"
port     = 993
username = "you@company.com"
password = "your-password"
tls      = true

[accounts.smtp]
host     = "smtp.company.com"
port     = 465
username = "you@company.com"
password = "your-password"
tls      = true   # implicit TLS on port 465
starttls = false

Port conventions:

Port Protocol
993 IMAP over TLS (tls = true)
143 IMAP with STARTTLS (tls = false)
465 SMTP over TLS (tls = true)
587 SMTP with STARTTLS (starttls = true)

Adding to Claude Desktop (stdio)

  1. Make sure mcp-imap is on your PATH or note its full path:bash which mcp-imap # e.g. /usr/local/bin/mcp-imap

  2. Open the Claude Desktop config file:

Platform Path
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json
  1. Add the server under mcpServers:json { "mcpServers": { "mcp-imap": { "command": "/usr/local/bin/mcp-imap", "args": [] } } }

If you need to point to a custom config file:json { "mcpServers": { "mcp-imap": { "command": "/usr/local/bin/mcp-imap", "args": ["--config", "/path/to/config.toml"] } } }

  1. Restart Claude Desktop. The email tools should appear in the tool picker.

Streamable HTTP transport

For use with other MCP clients or reverse proxies:```bash
mcp-imap --transport http --port 8080

MCP IMAP server listening on :8080/mcp


The single endpoint is `POST /mcp`.

Environment variable equivalents:```bash
MCPIMAP_TRANSPORT=http MCPIMAP_PORT=8080 mcp-imap

Available tools

Tool Description Read-only
account_list List configured accounts ✅
mailbox_list List all folders with message counts ✅
email_list List emails with optional filters (all / unread / flagged) and pagination ✅
email_search Search emails by subject, sender, recipient, body, date range, or flag ✅
email_get Full email detail — headers, body, attachments, message-id ✅
email_send Send a new email (plain text, HTML, or both) —
email_reply Reply to an email with correct threading headers —
email_draft Save a draft to the Drafts folder —
email_move Move an email to another folder —
email_archive Move to the configured archive folder —
email_bulk_archive Archive multiple emails in one operation —
email_set_flags Add or remove flags (seen, flagged, answered, deleted) —
email_delete Permanently delete (expunge) an email ⚠️ destructive

Example: listing unread emails```

email_list(mailbox="INBOX", filter="unread", limit=10)


### Example: searching emails```
email_search(mailbox="INBOX", from="alice@example.com", since="2026-01-01")
email_search(mailbox="INBOX", subject="invoice", has_flag="unseen")
email_search(mailbox="INBOX", body="project kickoff", before="2026-03-01", limit=20)

email_search parameters:

Parameter Description
account Account name (uses first account if omitted)
mailbox Mailbox to search (default: INBOX)
subject Subject contains this text
from Sender address or name contains this text
to Recipient address or name contains this text
body Full-text search across headers and body
since Sent on or after this date (YYYY-MM-DD)
before Sent before this date (YYYY-MM-DD)
has_flag seen, unseen, flagged, or answered
limit Max results (default: 50)
offset Skip N results for pagination

All criteria are combined with AND and evaluated server-side.

Example: getting email detail```

email_get(email_id="43671", mailbox="INBOX")


Returns:```json
{
  "email_id": "43671",
  "subject": "Hello",
  "from": [{ "name": "Alice", "email": "alice@example.com" }],
  "to":   [{ "name": "Bob",   "email": "bob@example.com" }],
  "date": "2026-03-28T10:00:00+01:00",
  "flags": ["\\Seen"],
  "flagged": false,
  "seen": true,
  "message_id": "<abc123@mail.example.com>",
  "body_text": "Hi Bob, ...",
  "attachments": []
}

Development```bash

just build # build binary to ./dist/mcp-imap
just run-stdio # run with stdio transport
just run-http # run with HTTP transport on :8080
just ui # open config UI on :3456
just tidy # go mod tidy
```

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
mcp-imap 怎么安装?

在客户端按下面的安装命令接入:/usr/local/bin/mcp-imap。装完在客户端配置里引用同一个包或端点。

mcp-imap 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

mcp-imap 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

mcp-imap 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

mcp-imap 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

mcp-imap 能提供哪些能力?

资料显示能力标签包括 Local Deployment、Email Service、IMAP、Go、SMTP、MCP Server。具体工具清单以官方文档为准。

mcp-imap 需要什么运行环境?

运行时为 go;属于本地进程,需要在本机装好运行环境。

mcp-imap 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-03-30。