广告合作
MCP.so
登录
M

Mail Shadow MCP Server

@dryas

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

dryas

提交者

Benjamin Kaiser

关于 Mail Shadow MCP Server

MCP server for structured, read-only email access. Exposes a minimal, auditable API surface — AI agents can search and read emails, but cannot send, delete, or modify your mailbox.

#mail#server#ai-agent#llm#secure

Mail Shadow MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mail_shadow": {
      "command": "/path/to/mail-shadow-mcp",
      "args": [
        "serve",
        "--config",
        "/path/to/config.yaml"
      ]
    }
  }
}

Mail Shadow MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Mail Shadow MCP?

Mail Shadow MCP is a Model Context Protocol (MCP) server that creates a local shadow copy of your IMAP mailboxes in a SQLite database. Instead of connecting directly to your IMAP server, AI agents query the local database through well-defined MCP tools, providing structured email access with built-in safety guarantees.

How to use Mail Shadow MCP?

Configure a config.yaml file with your IMAP account credentials, then run ./mail-shadow-mcp serve (or docker run for containerized deployments). Integrate with MCP clients (Claude Desktop, Cursor, etc.) by pointing them to the server via stdio or StreamableHTTP transport. Use the provided MCP tools like search_emails, get_thread, and download_attachments to interact with your mail.

Key features of Mail Shadow MCP

  • Local SQLite shadow database – no direct IMAP access for agents
  • Read-only mailbox – no STORE, APPEND, or EXPUNGE commands
  • Incremental sync – fetches only new messages since last sync
  • Full-text search via SQLite FTS5 index
  • Multi-account support – sync any number of IMAP accounts
  • Optional IMAP IDLE for near‑instant new‑mail notifications
  • Soft‑delete (IMAP MOVE to configurable trash folder)
  • Flexible transport: stdio, HTTP (StreamableHTTP), or SSE

Use cases of Mail Shadow MCP

  • AI agents answering questions about recent emails or threads
  • Automated inbox triage and notification summarization
  • Searching email bodies for specific topics or attachments
  • Building a read‑only, auditable email archive for AI consumption
  • Safe mailbox exploration without risk of accidental deletion

常见问题

1

What happens when an agent calls `delete_mail`?

The server performs an IMAP MOVE to a configurable trash folder and removes the local database entry. No email is ever permanently deleted; it remains intact on the IMAP server in the trash folder.

2

What runtime dependencies does Mail Shadow MCP require?

It requires Go 1.25+ to build from source. Pre‑built Docker images for `linux/amd64` and `linux/arm64` are available on GitHub Container Registry.

3

Where does my email data live?

All synced email data is stored in a local SQLite database at the path specified in `config.yaml` (e.g., `data/mail.db`). Attachments are cached in a local directory. The AI agent never contacts the remote IMAP server directly.

4

What authentication and transport options are available?

For `stdio` transport (local clients), no extra auth is needed. For `http` or `sse` transport (remote/Docker), you must set `http_bearer_token` in `config.yaml` and include an `Authorization: Bearer <token>` header in every request.

5

Does Mail Shadow MCP support IMAP IDLE for real‑time sync?

Yes. You can list folders (e.g., `INBOX`) in the `idle_folders` configuration section. The server opens a dedicated IMAP connection for each folder and triggers an immediate sync upon `EXISTS` notifications, falling back to polling if IDLE is unsupported.

评论

其他 分类下的更多 MCP 服务器

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K
广告合作