広告掲載
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.

コメント

「その他」の他のコンテンツ

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

広告掲載