Remove specific account references from public documentation

- Replace FETCHERPAY with generic CUSTOM account examples
- Update README.md, .env.example, and DEPLOY.md with generic configurations
- Remove hardcoded IPs, email addresses, and domain names
- Update package.json description to be more generic

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
garfieldheron
2026-03-05 13:37:51 -05:00
parent c5f342781a
commit 9ecb02785c
4 changed files with 72 additions and 74 deletions

View File

@@ -1,17 +1,17 @@
# Hermes MCP
A multi-account email MCP server for [Claude AI](https://claude.ai).
Supports **Yahoo Mail** (IMAP App Password) and any **self-hosted mail server** (Dovecot / Poste.io).
Supports **Yahoo Mail** (IMAP App Password) and any **self-hosted mail server** (IMAP/SMTP).
---
## Features
- Read, search, and send email from Claude via MCP
- Multi-account: connect Yahoo and a custom IMAP/SMTP server simultaneously
- Multi-account support: Yahoo Mail and custom IMAP/SMTP servers
- Streamable HTTP transport (MCP 1.x) + legacy SSE endpoint
- Automatic session recovery after server restarts
- Deployable to Kubernetes (MicroK8s example included)
- Docker and Kubernetes deployment ready
---
@@ -26,7 +26,7 @@ Supports **Yahoo Mail** (IMAP App Password) and any **self-hosted mail server**
| `create_draft` | Save a draft to the Drafts folder | `to`, `subject`, `body`, `account` |
| `send_email` | Send an email | `to`, `subject`, `body`, `account` |
`account` defaults to `"yahoo"`. Set to `"fetcherpay"` (or whatever you name your second account) for the custom mailbox.
`account` parameter allows you to specify which configured mailbox to use (defaults to `"yahoo"`).
---
@@ -60,19 +60,17 @@ Copy `.env.example` to `.env` and fill in your values:
YAHOO_EMAIL=you@yahoo.com
YAHOO_APP_PASSWORD=xxxx xxxx xxxx xxxx
# Self-hosted mail (Dovecot / Poste.io / any IMAP server)
FETCHERPAY_EMAIL=you@yourdomain.com
FETCHERPAY_PASSWORD=yourpassword
FETCHERPAY_IMAP_HOST=your-mail-server-ip
FETCHERPAY_IMAP_PORT=993
FETCHERPAY_SMTP_HOST=your-mail-server-ip
FETCHERPAY_SMTP_PORT=587
# Optional: Self-hosted mail server (any IMAP/SMTP server)
# CUSTOM_EMAIL=you@yourdomain.com
# CUSTOM_PASSWORD=yourpassword
# CUSTOM_IMAP_HOST=mail.yourdomain.com
# CUSTOM_IMAP_PORT=993
# CUSTOM_SMTP_HOST=mail.yourdomain.com
# CUSTOM_SMTP_PORT=587
PORT=3456
```
> **Tip:** Use the server's direct IP for `FETCHERPAY_IMAP_HOST` / `FETCHERPAY_SMTP_HOST` to avoid DNS resolution issues in Kubernetes.
---
## Connecting to Claude.ai
@@ -107,9 +105,9 @@ Claude.ai ──POST /mcp──► StreamableHTTPServerTransport
imapflow (IMAP) nodemailer (SMTP)
│ │
┌────────▼───┐ ┌───────▼───────┐
│ Yahoo Mail │ │ Self-hosted
imap.mail │ │ Dovecot /
.yahoo.com │ │ Poste.io
│ Yahoo Mail │ │ Custom IMAP/
│ │ SMTP Server
│ │ (optional)
└────────────┘ └───────────────┘
```