Metadata-Version: 2.4
Name: universal-email-mcp
Version: 0.0.1
Summary: Vendor-neutral MCP server for IMAP, POP3 and SMTP mailboxes: multi-account, multi-user, self-hostable
Keywords: mcp,model-context-protocol,imap,smtp,pop3,email
Author: Harald Schilly
Author-email: Harald Schilly <info@arjoma.at>
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications :: Email
Requires-Dist: cryptography>=50
Requires-Dist: imapclient>=4.1
Requires-Dist: mcp>=2.2
Requires-Dist: pydantic>=2.13
Requires-Dist: starlette>=1.7
Requires-Dist: uvicorn>=0.54
Requires-Dist: google-cloud-firestore>=2.33 ; extra == 'gcp'
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/arjoma/universal-email-mcp
Project-URL: Issues, https://github.com/arjoma/universal-email-mcp/issues
Project-URL: Changelog, https://github.com/arjoma/universal-email-mcp/blob/main/CHANGELOG.md
Provides-Extra: gcp
Description-Content-Type: text/markdown

# universal-email-mcp

> **Status: under development — not usable yet.** Version 0.0.1 only reserves the
> package name. Follow the [design plan](docs/plans/2026-09-30-design.md).

A vendor-neutral [Model Context Protocol](https://modelcontextprotocol.io) server that
connects AI assistants (Claude, ChatGPT, any MCP client) to ordinary mailboxes over
**IMAP, POP3 and SMTP** — for everyone whose mail is not on Gmail: web hosters,
self-hosted servers, Exchange on-prem, and the like.

Planned highlights:

- **Several accounts per user** — search across all IMAP/POP3 mailboxes at once, send
  from the right identity automatically, per-account permissions (e.g. read-only).
- **Smart retrieval** — time windows, fuzzy matching of people, subjects and folders,
  contact lookup from your mail history.
- **Two modes** — a local single-user server (stdio) and a multi-user remote server
  with built-in OAuth 2.1 and a self-service portal.
- **Safe by design** — mail is treated as untrusted input; the server checks
  recipients (new or look-alike addresses) before anything is sent; no permanent
  deletion.
- **Operable** — encrypted credentials, pseudonymous audit logging, admin policy;
  reference deployment on Google Cloud Run.

## License

Apache License 2.0 — see [LICENSE](LICENSE) and [NOTICE](NOTICE).
Copyright 2026 ARJOMA FlexCo.
