Free email address
for Hermes

Hermes Agent, from Nous Research, talks to you in the terminal or in Telegram, Discord, Slack and WhatsApp. It keeps skills (folders of task instructions and scripts) in ~/.hermes/skills/. It can install a skill straight from a path in a GitHub repository.

The Revdoku skill is at skills/revdoku in the public revdoku/revdoku repository. It comes with the Revdoku command-line tool. Create a free Revdoku mailbox before you start.

1. Preview the skill files: hermes skills inspect revdoku/revdoku/skills/revdoku
2. Install the skill: hermes skills install revdoku/revdoku/skills/revdoku
3. In a Hermes chat, send this slash command: /revdoku show my mailbox address
4. The first Revdoku command prints a sign-in link. Open it on any device and select Connect.

Hermes runs every skill from a GitHub path through Skills Guard, its security scanner. A repository outside its trusted list, such as revdoku/revdoku, gets the community trust level. If a chat is open during the install, your next message names the new skill. You do not have to restart Hermes.

If you use the skills CLI from npm, the agent name for Hermes is hermes-agent: npx skills add revdoku/revdoku --skill revdoku -g --agent hermes-agent

MCP (Model Context Protocol) lets an agent call tools on another server. Hermes connects to remote MCP servers that use browser sign-in. Choose this route when Hermes does not have to upload local files to the mailbox.

1. Add this block to ~/.hermes/config.yaml:

   mcp_servers:
     revdoku:
       url: "https://mcp.revdoku.com"
       auth: oauth
       tools:
         exclude: [mailbox_delete_permanently, mailbox_email_delete]

2. Run hermes mcp login revdoku. Hermes prints a sign-in URL and opens your browser when it can.
3. On the Revdoku permission screen, select the mailbox for Hermes. Choose Read only for digests of saved email. Choose Read & write if Hermes must show the address or reply.
4. If Hermes runs on a server without a browser, copy the final redirect URL from your browser. Paste it at the Hermes prompt.
5. In a running Hermes session, send /reload-mcp.

Hermes keeps the token in ~/.hermes/mcp-tokens/revdoku.json. It names each tool with a prefix, for example mcp_revdoku_mailbox_email_list. The exclude list hides the two delete tools from the agent.

• Subscribe to newsletters with the mailbox address. Hermes reads each issue and sends you the main points in Telegram.
• Send CI, uptime or billing alerts to the address. Hermes tells you which alerts need action.
• Hermes keeps notes or a research report as text files in the mailbox, next to the email that started the task. Over MCP it uses mailbox_file_write.
• When you ask, Hermes replies to the sender of an alert. Revdoku adds the reply to the conversation of the original email.

Hermes cron (its scheduler for recurring jobs) runs agent jobs inside the Hermes gateway, so the gateway must be running. A job that you create in Telegram sends its result back to that chat.

/cron add "weekdays at 8am" "Read the emails that arrived in my Revdoku mailbox in the last 24 hours. Give each one a one-line summary and say which need an answer. Do not reply to or delete anything." --skill revdoku

In the terminal, the same job starts with hermes cron create, followed by the same schedule, prompt and --skill revdoku. Add --name "Mailbox digest" to label it. The terminal version saves its output in ~/.hermes/cron/output/.

Hermes compares each shell command with a list of dangerous patterns before it runs it. In the default smart mode, a helper model approves low-risk commands, denies dangerous ones and asks you about the rest. For a prompt on every dangerous command, set approvals.mode to manual in config.yaml.

A cron job reads new mail when you are not at the screen. The Revdoku skill tells Hermes that email bodies and attachments are untrusted data, and Hermes must not follow instructions in them.

To remove the skill, run hermes skills uninstall revdoku. To remove the MCP server, delete its block from config.yaml and send /reload-mcp. You approve each Hermes connection separately in Revdoku, under Account → Access.

Hermes skills · Hermes MCP · Revdoku MCP guide · Use cases